Polza.AI
Интеграция · Gemini CLI

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

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

Получить API-ключКак подключитьДокументация
  • Работает из РФ напрямую
  • Карта РФ и СБП
  • Аккаунт Google не нужен
  • Claude и GPT в том же CLI
~/project · gemini

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

GOOGLE_GEMINI_BASE_URL https://api.polza.ai/

GEMINI_API_KEY sk-polza-••••••••••••

> разбери структуру проекта и напиши тесты

✓ прочитано 42 файла, создано 8 тестов

Так выглядит подключение: ключ, адрес API и модель.

Что такое Gemini 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. Шаг 1

    Установите CLI

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

    Терминал · установка
    $ npm install -g @google/gemini-cli
$ gemini --version

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

  2. Шаг 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. Шаг 3

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

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

    Выбор модели
    $ gemini --model anthropic/claude-sonnet-5

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

  4. Шаг 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

Gemini CLI: Напрямую или через Polza
Из РоссииGoogle напрямуюGemini CLI через Polza
ОплатаЗарубежная карта, в долларахКарта РФ, СБП, счёт для юрлиц
Доступ к APIЗакрыт, нужны обходные путиРаботает из РФ напрямую
АвторизацияАккаунт Google с привязкой к регионуКлюч Polza, аккаунт не нужен
Модель оплатыДневная квота, потом отказЗа токены, лимиты не сгорают
Выбор моделейТолько GeminiClaude, 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

anthropic/claude-fable-5

длинные автономные сессии

Anthropic: Claude Sonnet 5

anthropic/claude-sonnet-5

ежедневная разработка

OpenAI: GPT-5.5

openai/gpt-5.5

рассуждения

Google: Gemini 3.5 Flash

google/gemini-3.5-flash

быстрая и мультимодальная

DeepSeek: DeepSeek V4 Pro

deepseek/deepseek-v4-pro

самый дешёвый Pro-класс

MoonshotAI: Kimi K2.7 Code

moonshotai/kimi-k2.7-code

end-to-end кодинг

Актуальные цены за 1M токенов — в каталоге моделей.

Если 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, как у остальных.

Для команд и юрлиц

Счёт, УПД и НДС

Оплата по счёту для ООО и ИП, договор с российским юрлицом, закрывающие документы каждый месяц.

Ключ на сотрудника

Отдельные ключи с общим балансом организации: видно, кто и сколько потратил.

Контроль бюджета

Статистика расходов по ключам и моделям в кабинете, без сюрпризов в конце месяца.

Помощь с переездом

Поможем перевести команду с зарубежных подписок на API: настройка окружений и правила расходования.

Вопросы и ответы

Работает ли 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".

Другие интеграции

Тот же ключ работает в остальных инструментах: меняется только место, куда вписать Base URL.

Claude Coden8nKilo CodeCherry StudioClineCline DesktopRoo CodeCodex CLIChatGPT DesktopClaude DesktopHermes AgentDeepSeek HarnessDifyLangChainOpenCodeOpenClawOpenClaw DesktopQwen Code CLIPolza IDEPolza.AI Proxy

Что почитать

Российский API нейросетей без VPN

Читать в блоге

API нейросетей: единый ключ для ChatGPT, Claude и 400+ моделей

Читать в блоге

Claude Sonnet 5: обзор модели — цены и бенчмарки

Читать в блоге

Кто проверял эту инструкцию

Илья Дашкин

Основатель Polza.AI · редакция Polza.AI

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

Обновлено · Как работает редакция · Нашли неточность? Напишите нам

Подключите Gemini CLI за две минуты

Две переменные окружения — и в терминале работают Claude, GPT и Gemini, из России и за рубли.

Получить API-ключ

Остались вопросы? Документация по Gemini CLI, поддержка в Telegram или support@polza.ai

Инструкцию проверила редакция Polza.AI, обновлено . Цены и список моделей меняются — актуальные смотрите в каталоге.

Сайт использует cookie.