Gemini CLI в России: как установить и настроить

Установить Gemini CLI из России можно без VPN и без ухищрений — это обычный npm-пакет, он скачивается и запускается на любой машине. Упирается всё на следующем шаге: 18 июня 2026 года Google перестал обслуживать запросы Gemini CLI для бесплатных аккаунтов и подписчиков Google AI Pro и Ultra, а единственный оставшийся путь — вход по API-ключу — требует биллинга в регионе, где Россия не числится. Ниже разбираем, как агент ставится, как устроены три способа входа, почему ни один из них не доводит до работающей модели из России и чем закрыть ту же задачу — агента прямо в терминале — через AI для кода от PurpleSchool.

Что такое Gemini CLI и почему бесплатный доступ закрыли

Gemini CLI — открытый терминальный AI-агент от Google. Он живёт в консоли, видит файлы проекта, правит их, выполняет команды и держит контекст между запросами: тот же жанр, что Claude Code или Codex CLI. Когда инструмент вышел, его главным аргументом была щедрая бесплатная квота по входу через обычный Google-аккаунт — мы разбирали его возможности в видеообзоре Gemini CLI.

Этого аргумента больше нет. В официальном объявлении мейнтейнера в репозитории проекта сказано прямо: Gemini CLI прекращает обслуживать запросы для аккаунтов Google AI Pro, Google AI Ultra и бесплатного уровня. Без изменений остались две категории — корпоративные лицензии Gemini Code Assist и аутентификация по API-ключу. Google консолидирует инструменты для разработчиков под брендом Antigravity, и заменой Gemini CLI объявлен Antigravity CLI.

Для читателя из России это значит две разные проблемы, которые важно не перепутать:

• Глобальная. Бесплатный вход по Google-аккаунту отключён у всех, независимо от страны. Это не блокировка России, это смена политики продукта.
• Региональная. Пути, которые продолжают работать, завязаны на Gemini API и Google Cloud, а Россия в список поддерживаемых регионов не входит.

Поэтому дальше нет смысла искать «рабочий обход для Gemini CLI» — обходить придётся не географию, а решение Google о закрытии бесплатного уровня. Но установку всё равно разберём: инструмент открытый, он никуда не делся, и если у вас есть доступ через работодателя с корпоративной лицензией, всё описанное ниже вам пригодится.

Как установить Gemini CLI

Три способа, все дают одну и ту же команду gemini в терминале. Установка не зависит от страны и работает на macOS, Windows и Linux.

Установка через npm

Основной способ. Сначала проверьте, что в системе есть Node.js:

node -v

Конкретный минимум версии у проекта менялся, поэтому ориентируйтесь не на цифру из статьи, а на поведение npm: если установленная версия ниже требуемой, установка остановится с ошибкой EBADENGINE и покажет нужный диапазон. В этом случае обновите Node.js до актуальной LTS-версии и повторите. Сам пакет ставится глобально:

npm install -g @google/gemini-cli

После установки перезапустите терминал. Без перезапуска свежий PATH не подхватится и команда gemini не найдётся — это самая частая причина ошибки «command not found» сразу после успешной установки.

Запуск через npx без установки

Если нужно просто посмотреть на инструмент и не оставлять его в системе, глобальная установка не обязательна:

npx https://github.com/google-gemini/gemini-cli

npx скачает пакет во временный каталог, запустит его и не станет прописывать команду в систему. Удобно для одной проверки, неудобно для ежедневной работы: каждый запуск снова тянет пакет.

Установка через Homebrew

На macOS и Linux есть формула в Homebrew:

brew install gemini-cli

Этот путь сам притащит нужную версию Node.js как зависимость, так что проверять node -v заранее не придётся.

Удалить агента, если он больше не нужен, можно той же командой, которой ставили, с обратным действием:

npm uninstall -g @google/gemini-cli

Три способа входа и что из них работает

При первом запуске gemini предлагает выбрать способ аутентификации. Вариантов три, и после июньских изменений они находятся в очень разном состоянии.

Вход через Google-аккаунт

Раньше это был путь по умолчанию: агент открывал браузер, вы подтверждали вход, квота выдавалась на обычный личный аккаунт. Именно этот способ Google и отключил для бесплатного уровня и подписок AI Pro и Ultra. Сегодня он остаётся живым только для корпоративных лицензий Gemini Code Assist, то есть когда доступ выдаёт организация.

API-ключ Google AI Studio

Этот способ Google в объявлении назвал незатронутым, и технически так и есть: агент читает ключ из переменной окружения GEMINI_API_KEY. На macOS и Linux переменная прописывается в профиль оболочки:

export GEMINI_API_KEY="ваш ключ"

На Windows в PowerShell так, чтобы значение пережило перезапуск:

[Environment]::SetEnvironmentVariable('GEMINI_API_KEY','ваш ключ','User')

Механика переменных окружения и разница между значением на сессию и постоянным описаны в базе знаний — в статьях про переменные окружения и команду export.

Проблема не в синтаксисе, а в том, откуда берётся сам ключ. Выдаёт его Google AI Studio, и Россия в список поддерживаемых регионов Gemini API не входит. Проверок при этом две: страна в профиле аккаунта и адрес, с которого уходит запрос. Пройти обе из России без зарубежного аккаунта и зарубежного сервера не получится, а платная квота поверх ключа упирается в тот же зарубежный биллинг, что и подписки, — ровно тот сюжет, который мы разбирали в материале про API-ключ Claude.

Vertex AI

Третий путь ведёт в Google Cloud: проект, включённый биллинг, доступ к моделям через Vertex AI. Для компании с аккаунтом в GCP это рабочая схема, для частного разработчика из России — те же два препятствия, карта и регион, только с добавлением настройки облачного проекта.

Почему подмена адреса API здесь не помогает

В агентах вроде Cline или Qwen Code из России выручает один приём: в настройках подменяется адрес эндпоинта, и агент начинает ходить за ответами к совместимому прокси с рублёвой оплатой вместо недоступного официального API. У Gemini CLI переопределение базового адреса тоже предусмотрено — через переменную GOOGLE_GEMINI_BASE_URL, она есть в проекте и используется для корпоративных шлюзов и локальных моделей.

Только это не та лазейка, на которую хочется надеяться. Переменная подменяет адрес, но не протокол: на другом конце агент по-прежнему ждёт сервис, говорящий на Gemini API. Прокси с Anthropic- или OpenAI-совместимым интерфейсом сюда не подставить — формат запроса не совпадёт. Gemini CLI спроектирован вокруг экосистемы Google: авторизация, адреса, формат — всё завязано на неё, и официального переключения на другого поставщика модели в нём нет.

Существуют сторонние мосты-переходники, которые превращают один протокол в другой. Это чужой код, через который пойдёт ваш API-ключ и содержимое вашего проекта, поэтому в рабочем окружении советовать их не станем.

Antigravity CLI, которым Google заменяет Gemini CLI, региональную проблему не решает: Россия в поддерживаемых регионах Antigravity тоже не числится.

Что поставить вместо Gemini CLI из России

Если за Gemini CLI вам нужен не конкретно Gemini, а агент в терминале, который читает проект и правит файлы, — задача решается сменой инструмента, а не обходом блокировок. Агенты этого класса умеют работать с совместимым эндпоинтом, и адрес у них меняется штатной настройкой.

Рабочая связка — Claude Code или Codex CLI, подключённые к Anthropic-совместимому прокси PurpleSchool: за ним стоят модели Claude и GPT, ключ выдаётся в личном кабинете, платится российской картой. Пошаговая установка разобрана в статье про Claude Code в России, а если выбор между агентами ещё не сделан — в сравнении Codex и Claude Code.

Коротко, в чём разница с Gemini CLI по пунктам, которые упирались:

• Вход. Не Google-аккаунт и не облачный проект, а ключ из личного кабинета.
• Оплата. Рубли, российская карта, без зарубежного биллинга.
• Регион. Проверки на страну аккаунта нет, VPN не нужен.
• Смена провайдера. Адрес эндпоинта задаётся настройкой, это штатный сценарий, а не обход.

Сколько стоит доступ к Claude и GPT

На странице AI для кода три тарифа с ежемесячным лимитом токенов: «Помощник» за 499 рублей с 2,5 млн токенов, «Напарник» за 1199 рублей с 5,5 млн и «Соавтор» за 2499 рублей с 12,5 млн. Баланс общий для всех доступных моделей Claude и GPT, неизрасходованные токены переносятся на следующий месяц, но дольше одного цикла не накапливаются. Подписка отменяется в любой момент в кабинете.

Ключ появляется сразу после оплаты. Прописывать его по конфигам вручную не обязательно — есть установщик, который сам найдёт установленные инструменты и пропишет ключ и адрес прокси:

npx @purpleschool/ai-for-code

Ему нужен Node.js версии 22 или выше — тот же Node.js, который вы проверяли командой node -v на шаге установки.

Заключение

Поставить Gemini CLI из России просто: npm install -g @google/gemini-cli, перезапуск терминала, команда gemini. Настроить его так, чтобы он отвечал, — нельзя: бесплатный вход по Google-аккаунту Google закрыл 18 июня 2026 года для всех, а оставшиеся пути через API-ключ и Vertex AI требуют аккаунта в поддерживаемом регионе и зарубежной карты. Переопределение адреса через GOOGLE_GEMINI_BASE_URL ограничение не снимает, потому что подменяет адрес, а не протокол.

Если нужен работающий из России терминальный агент, быстрее и честнее взять тот, у которого смена эндпоинта — штатная функция: Claude Code или Codex CLI с ключом PurpleSchool ставятся за несколько минут и оплачиваются рублями.