Работа с Gemini CLI в Windows: установка и настройка соединения

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

Что такое Gemini CLI

Gemini CLI запускается в терминале и работает с текущей директорией как с проектом. Типичные сценарии: объяснить незнакомый код, сгенерировать функцию, прогнать рефакторинг по нескольким файлам, разобрать историю в Git. Инструмент понимает контекст репозитория, поэтому его удобно держать рядом с рабочим деревом.

Чем он похож на Codex CLI

По задачам Gemini CLI близок к Codex CLI: тот же формат агента в консоли, отличается провайдер модели и способ входа. Если вы уже работали с одним из них, второй освоите быстро, команды и логика похожи. Совет: держите оба под рукой и выбирайте по задаче, а не по привычке.

Установка Gemini CLI

Нужен установленный Node.js. Пакет ставится глобально через npm:

npm install -g @google/gemini-cli

После этого команда gemini доступна в любом каталоге.

Установка из GitHub

Исходники и issues лежат на GitHub, там же документация и примеры. Если хотите собрать из репозитория, склонируйте его и следуйте инструкции в README. Для большинства случаев глобальной установки через npm достаточно, сборка из GitHub нужна, когда вы правите сам инструмент или тестируете свежие правки.

Аутентификация

При первом запуске Gemini CLI предложит выбрать способ входа. Вариант с Google OAuth удобен для личного использования: браузер открывает страницу входа, вы подтверждаете доступ, и токен сохраняется локально.

Варианты входа

Кроме OAuth есть вход по API-ключу и через Vertex AI для корпоративных сценариев на GCP. API-ключ удобно держать в переменной окружения, тогда gemini подхватит его без интерактивного шага. Совет: для личных задач берите OAuth, для CI и серверов, API-ключ или Vertex AI, чтобы не завязываться на браузерный вход.

Зачем разводить трафик

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

Как направить только Gemini CLI через прокси

Windows не умеет маршрутизировать трафик по приложениям, он гоняет всё через общий адаптер. Proxy Control решает эту одну задачу: поднимает виртуальный сетевой адаптер (TUN) на sing-box, забирает в него весь трафик машины и раздаёт по правилам, привязанным к имени процесса.

Четыре канала

Есть четыре канала: Дом (обычный интернет провайдера), VPN (ваш узел), Прокси (через HTTP CONNECT) и Блок (соединение отклоняется). Процесс node вы назначаете на нужный канал, а всё остальное оставляете дома. Системный VPN включать не требуется.

Поведение по умолчанию

По умолчанию неизвестное блокируется. Новая программа появляется в списке со статусом «ожидает» и в интернет не выйдет, пока вы вручную не назначите ей канал. Это сделано намеренно: явный отказ лучше незаметной утечки. После первого запуска gemini найдите его процесс в списке и распределите.

Применение маршрутов

После смены канала нажмите «Применить маршруты». Появится подтверждение с отсчётом 10 секунд: столько система будет без сети, пока пересобирается туннель. Последовательность фиксированная: ставится блокирующее правило брандмауэра, останавливается sing-box, программа ждёт исчезновения адаптера, запускает заново и снимает правило. Трафик на это время не уходит мимо маршрутов, а просто встаёт на несколько секунд.

Проверка канала

Чтобы не гадать, каким каналом на самом деле идёт процесс, в программе есть живая сверка через локальный API sing-box: виден фактический канал каждого процесса, а не то, что записано в конфиге. Отдельно работают три пробы (копии curl, прибитые к каналам), они запрашивают внешний IP и показывают три разных адреса. Если IP канала совпал с домашним, программа сообщит про утечку, а не покрасит статус в зелёный.

Установка Proxy Control

Скачайте архив, распакуйте целиком и запустите Install.bat, он попросит подтверждение администратора. Python и sing-box лежат внутри, интернет при установке не нужен, ставить заранее ничего не требуется. Туннель поднимается сам при запуске программы, старт проходит 15 шагов с проверками.

Ключ и удаление

Для работы нужен ключ вида CPC-XXXXXX-XXXXXX, один ключ на один компьютер. По нему программа получает срок действия и персональные реквизиты прокси. Удаление, Uninstall.bat: снимает туннель, правило брандмауэра, задания планировщика, ярлык и папку продукта. Лицензия при этом остаётся привязанной к компьютеру, освободить её можно в кабинете.

Тарифы

Подписка стоит 495 ₽/мес помесячно и от 395 ₽/мес при оплате за год, есть тарифы на 2, 3, 6 и 12 месяцев. Регистрация через почту или бота, поддержка в Telegram.