# Gemini CLI в России: Claude, GPT и 400 моделей в терминале

> Официальный CLI от Google работает из России через API Polza — и не только с моделями Google. Две переменные окружения, оплата картой РФ, аккаунт Google не нужен.

- Работает из РФ напрямую
- Карта РФ и СБП
- Аккаунт Google не нужен
- Claude и GPT в том же CLI

Gemini CLI — официальный инструмент Google для работы с моделями в терминале. Запускается командой gemini в папке проекта и дальше ведёт себя как агент: читает файлы, пишет код, выполняет команды и проверяет результат.

Код открытый, установка через npm. От редакторных ассистентов отличается тем, что живёт в терминале, — поэтому его удобно вызывать из скриптов, хуков и пайплайнов.

Название обманчиво: бэкенд задаётся переменной окружения, так что моделями Google дело не ограничивается. Через Polza в том же CLI работают Claude, GPT, DeepSeek и остальной каталог.

## Почему Gemini CLI не запускается из России

Сам CLI ставится одной командой npm. Упирается всё в бэкенд, куда он отправляет запросы.

- **Запросы не уходят.** API Google не обслуживает российские адреса: CLI ставится, авторизуется, но на первом же запросе возвращает ошибку. Решение: Адрес API Polza отвечает из РФ напрямую.
- **Нужен аккаунт Google.** Штатная авторизация ведёт в аккаунт Google с привязкой к региону, и российский IP приводит к отказу. Решение: Авторизация по ключу Polza, аккаунт не нужен.
- **Бесплатный лимит заканчивается.** Агентный режим читает десятки файлов за задачу и выбирает дневную квоту за пару часов работы. Решение: Оплата за токены: пополнил и работаешь.
- **Картой не оплатить.** Платный тариф Google требует зарубежную карту, а российская отклоняется на привязке. Решение: Карта РФ, СБП или счёт для юрлица.
- **Только модели Google.** Штатно CLI ходит в Gemini. Захотели сравнить с Claude или GPT — ставьте второй инструмент и заводите второй ключ. Решение: Один ключ ко всему каталогу из 400 моделей.
- **Юрлицу не провести оплату.** Зарубежная подписка не ложится в российскую отчётность. Решение: Договор, счёт, УПД и НДС.

## Как подключить Gemini CLI к Polza

Три шага и одна проверка. Переустанавливать CLI, если он уже стоит, не нужно — достаточно задать переменные окружения.

Что нужно:

- **Node.js 18 или выше.** Версия проверяется командой node --version. Сам CLI ставится глобально одной командой npm install -g @google/gemini-cli.
- **Ключ Polza.** Создаётся в кабинете за минуту. Пополняется картой РФ, через СБП или по счёту для юрлица.
- **ID модели.** Передаётся флагом --model или переменной GEMINI_MODEL. Написание должно совпадать с каталогом до символа.

### 1. Установите CLI

Нужен Node.js 18 или выше. Ставится глобально одной командой:

Терминал · установка:

```
$ npm install -g @google/gemini-cli
$ gemini --version

# версию Node.js проверьте командой node --version
```

### 2. Задайте переменные окружения

Два значения указывают CLI, куда ходить за моделями. Обратите внимание на адрес — здесь он отличается от остальных интеграций и заканчивается слешем:

macOS / Linux · ~/.zshrc:

```
export GOOGLE_GEMINI_BASE_URL="https://api.polza.ai/"
export GEMINI_API_KEY="ваш_ключ_polza_ai"
```

Windows · PowerShell:

```
$env:GOOGLE_GEMINI_BASE_URL = "https://api.polza.ai/"
$env:GEMINI_API_KEY = "ваш_ключ_polza_ai"
```

### 3. Выберите модель

Модель задаётся флагом при запуске или переменной по умолчанию. ID берутся из каталога и передаются как есть:

Выбор модели:

```
$ gemini --model anthropic/claude-sonnet-5

# или один раз, по умолчанию:
GEMINI_MODEL=anthropic/claude-fable-5
```

### 4. Запустите и авторизуйтесь

При первом запуске CLI спросит способ авторизации — выберите `API Key` и вставьте ключ Polza. Дальше всё как обычно.

Первый запуск:

```
$ gemini

# способ авторизации → API Key
  ✓ подключено к Polza.ai
```

**Переменные не переживают перезапуск терминала.** Если после закрытия терминала CLI снова просит авторизацию — значит переменные задались только на текущую сессию. На macOS и Linux допишите строки export в ~/.zshrc или ~/.bashrc, на Windows сохраните их через [System.Environment]::SetEnvironmentVariable с параметром "User".

## Что умеет Gemini CLI

Возможности, ради которых его держат в терминале рядом с редактором.

- **Агентный режим.** CLI сам разбивает задачу на шаги: читает файлы, пишет код, запускает команды и проверяет результат.
- **Работа с кодовой базой.** Анализирует проект целиком, предлагает рефакторинг и пишет тесты — контекста до 1M токенов хватает на большие репозитории.
- **Поддержка MCP.** Через Model Context Protocol подключаются внешние инструменты и сервисы: базы, трекеры, внутренние API.
- **Потоковый вывод.** Ответ печатается по мере генерации, а не через паузу — видно, куда идёт рассуждение, и можно прервать раньше.
- **Мультимодальность.** Изображения и PDF передаются прямо в запросе: скриншот с ошибкой или макет разбирается без пересказа словами.
- **Скрипты и CI.** CLI вызывается из bash-скриптов и пайплайнов — ревью диффа или генерация changelog запускаются по событию.

- **https://api.polza.ai/.** Для Gemini CLI. Он говорит на протоколе Google, поэтому идёт на отдельный поддомен и требует слеш на конце.
- **https://polza.ai/api/v1.** Для всего остального: n8n, Kilo Code, Cherry Studio, LangChain. Это OpenAI-совместимый интерфейс.

## Чем Gemini CLI отличается от Claude Code и Codex

Терминальных агентов уже несколько, и различает их в основном то, насколько легко сменить бэкенд.

- **Gemini CLI.** Открытый код, установка из npm, бэкенд задаётся переменными окружения. Поэтому переключается на сторонний API быстрее остальных — двумя строками.
- **Claude Code.** Сильнее в длинных автономных задачах, но настроен на своего провайдера. Через Polza работает тоже, под него есть отдельная страница.
- **Codex CLI.** Инструмент OpenAI с похожей логикой работы в терминале. Подключается по тому же принципу и тем же ключом.

## Напрямую или через Polza

| Из России | Google напрямую | Gemini CLI через Polza |
| --- | --- | --- |
| Оплата | Зарубежная карта, в долларах | Карта РФ, СБП, счёт для юрлиц |
| Доступ к API | Закрыт, нужны обходные пути | Работает из РФ напрямую |
| Авторизация | Аккаунт Google с привязкой к региону | Ключ Polza, аккаунт не нужен |
| Модель оплаты | Дневная квота, потом отказ | За токены, лимиты не сгорают |
| Выбор моделей | Только Gemini | Claude, GPT, Gemini, DeepSeek и ещё 400 |
| Документы | Нет | Договор, счёт, УПД, НДС |
| Расходы | В консоли Google | Статистика по ключам и моделям |

## Сколько стоит Gemini CLI в России

Сам CLI бесплатный и с открытым кодом. Платите только за токены моделей по ценам каталога, в рублях.

- **Автономные задачи.** Claude Fable 5 и Opus 4.8 — длинные агентные сессии, где CLI сам ведёт задачу до конца. Контекст 1M токенов, первое место в Code Arena.
- **Ежедневная работа.** Claude Sonnet 5 и GPT-5.5 — разбор проекта, рефакторинг, тесты. Лучший баланс цены и качества для постоянного использования.
- **Дёшево и много.** Gemini 3.5 Flash, DeepSeek V4 Pro и Kimi K2.7 Code — рутина, прогон по файлам и черновые правки. Кодинг уровня Pro по цене Flash.

- [anthropic/claude-fable-5](https://polza.ai/models/anthropic/claude-fable-5.md) — длинные автономные сессии
- [anthropic/claude-sonnet-5](https://polza.ai/models/anthropic/claude-sonnet-5.md) — ежедневная разработка
- [openai/gpt-5.5](https://polza.ai/models/openai/gpt-5.5.md) — рассуждения
- [google/gemini-3.5-flash](https://polza.ai/models/google/gemini-3.5-flash.md) — быстрая и мультимодальная
- [deepseek/deepseek-v4-pro](https://polza.ai/models/deepseek/deepseek-v4-pro.md) — самый дешёвый Pro-класс
- [moonshotai/kimi-k2.7-code](https://polza.ai/models/moonshotai/kimi-k2.7-code.md) — end-to-end кодинг

## Если CLI не отвечает

Четыре причины, на которые приходится почти вся переписка с поддержкой.

- **Ошибка 401 Unauthorized.** Переменная с ключом пуста. Проверьте её: echo $GEMINI_API_KEY, на Windows — echo $env:GEMINI_API_KEY.
- **Модель не найдена.** CLI передаёт ID как есть, поэтому опечатка приводит к ошибке. Сверьте написание с каталогом.
- **Переменные пропадают после перезапуска.** Допишите строки export в ~/.zshrc или ~/.bashrc. На Windows используйте SetEnvironmentVariable с параметром "User".
- **Запросы всё равно не проходят.** Проверьте адрес. У этой интеграции он https://api.polza.ai/ со слешем на конце, а не https://polza.ai/api/v1, как у остальных.

## Частые вопросы

### Работает ли Gemini CLI в России?

Да. Сам CLI ставится через npm без ограничений, а запросы направляются на API Polza, которое отвечает из России напрямую. VPN и прокси не нужны.

### Нужен ли аккаунт Google?

Нет. При первом запуске выберите способ авторизации API Key и введите ключ Polza — регистрация в Google не потребуется.

### Какой Base URL указывать?

https://api.polza.ai/ — именно с поддоменом api и слешем на конце. Это единственная интеграция с таким адресом: остальные используют https://polza.ai/api/v1.

### Можно ли работать с Claude и GPT?

Да, в этом и смысл подключения. CLI передаёт ID модели как есть, поэтому доступен весь каталог — Claude, GPT, DeepSeek, Kimi и сами Gemini.

### Что нужно установить?

Node.js 18 или выше и npm. Дальше одна команда: npm install -g @google/gemini-cli.

### Ошибка 401 Unauthorized

Переменная с ключом не задана или пуста. Проверьте её командой echo $GEMINI_API_KEY, на Windows — echo $env:GEMINI_API_KEY. Если пусто, задайте заново и перезапустите терминал.

### Модель не найдена

CLI передаёт ID модели без изменений, поэтому опечатка приводит к ошибке. Сверьте точное написание с каталогом моделей.

### Переменные пропадают после перезапуска

Они были заданы только на текущую сессию. Допишите export в ~/.zshrc или ~/.bashrc, на Windows используйте SetEnvironmentVariable с параметром "User".

## Читать дальше

- [Российский API нейросетей без VPN](https://polza.ai/blog/rossiyskiy-api-dlya-neyrosetey-bez-vpn-polnyy-gayd-2026.md)
- [API нейросетей: единый ключ для ChatGPT, Claude и 400+ моделей](https://polza.ai/blog/api-neyrosetei.md)
- [Claude Sonnet 5: обзор модели — цены и бенчмарки](https://polza.ai/blog/claude-sonnet-5.md)

## Ссылки

- Документация: https://polza.ai/docs/integracii/gemini-cli
- Страница: https://polza.ai/integrations/gemini-cli
- Обновлено: 2026-09-26