Блог

Gemini CLI в России (2026): как установить и пользоваться без VPN и без входа через Google

Короткий ответ

Оплатить можно и криптовалютой. В окне пополнения нажмите «Оплатить криптовалютой» и переведите USDT, USDC или ETH с Binance, OKX или любой другой биржи либо кошелька — от $5, без расширения, можно с телефона. Пошагово — в статье «Как оплатить Claude API в USDT».

Пользоваться Gemini CLI в России можно. Сама программа ставится как обычно — через npm, — а работать ей нужен доступ к моделям Gemini. Официальные пути из России закрыты: вход через Google для бесплатных и личных аккаунтов Google отключил с 18 июня 2026 года во всех странах, а ключ из Google AI Studio в России не выдают — страны нет в списке, где доступен Gemini API. Остаётся вариант «Use Gemini API Key» с ключом стороннего шлюза: Gemini CLI официально поддерживает свой адрес API через переменную GOOGLE_GEMINI_BASE_URL. Ниже — установка на трёх системах, подключение через TeamoRouter, первый запуск и разбор ошибок. Оплата — в рублях или в USDT.

Получить API-ключ — зарегистрируйтесь и пополните баланс от $5 в рублях через СБП, Т-Банк, ЮMoney или SberPay либо в USDT.

Что такое Gemini CLI

Gemini CLI — открытый агент Google для работы с кодом в терминале: команда gemini читает ваш проект, правит файлы, запускает команды и отвечает на вопросы по коду. Исходники — в репозитории google-gemini/gemini-cli, программа распространяется через npm как @google/gemini-cli. На 3 ноября 2026 года последняя версия — 0.66.0, ей нужен Node.js 20 или новее.

Что не работает из России и почему

Шаг Официальный путь Что происходит из России
Скачать и установить npm install -g @google/gemini-cli Работает: пакет лежит в публичном реестре npm и скачивается из России
Войти через Google («Sign in with Google») Бесплатный аккаунт Gemini Code Assist, Google AI Pro или Ultra Не работает нигде: с 18 июня 2026 года Google отключил этот вход для Gemini CLI и предлагает таким пользователям перейти на Antigravity CLI
Взять ключ в Google AI Studio GEMINI_API_KEY от Google России нет в списке стран, где доступны Gemini API и Google AI Studio
Обращаться к моделям напрямую Серверы Google Запрос отклоняется с ошибкой User location is not supported for the API use. — подробнее в статье «Gemini API в России»

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

Шаг 1. Как установить Gemini CLI

Что нужно заранее

Node.js 20 или новее. Проверить версию: node --version. Если Node.js нет, поставьте актуальную LTS-версию с nodejs.org.

Установка

macOS и Linux:

bash
npm install -g @google/gemini-cli

На macOS и Linux можно и через Homebrew: brew install gemini-cli.

Windows — в PowerShell, после установки Node.js:

powershell
npm install -g @google/gemini-cli

Проверьте, что программа установилась:

bash
gemini --version

Попробовать без установки можно командой npx @google/gemini-cli.

Шаг 2. Ключ и подключение

У нового аккаунта баланс $0 — пополните его до первого запроса. Пополнить можно от $5. Если запрос возвращает 402 с текстом «wallet balance is insufficient», значит, баланс пуст, а адрес и ключ настроены правильно. Пополните баланс и повторите запрос.

Получите ключ

Откройте консоль TeamoRouter, создайте API-ключ (он начинается с sk-teamo-) и скопируйте его целиком.

Пропишите три переменные

macOS и Linux — замените sk-teamo-ваш-ключ своим ключом и вставьте блок в терминал. Он создаст файл ~/.gemini/.env, который Gemini CLI читает при запуске:

bash
mkdir -p ~/.gemini && cat > ~/.gemini/.env <<'EOF'
GOOGLE_GEMINI_BASE_URL=https://api.teamorouter.com
GEMINI_API_KEY=sk-teamo-ваш-ключ
GEMINI_API_KEY_AUTH_MECHANISM=bearer
EOF

Windows — выполните в PowerShell, затем закройте и снова откройте окно терминала:

powershell
setx GOOGLE_GEMINI_BASE_URL "https://api.teamorouter.com"
setx GEMINI_API_KEY "sk-teamo-ваш-ключ"
setx GEMINI_API_KEY_AUTH_MECHANISM "bearer"

Что делает каждая переменная:

  • GOOGLE_GEMINI_BASE_URL — адрес шлюза. Пишите ровно https://api.teamorouter.com, без /v1 на конце: путь /v1beta/models/... Gemini CLI добавляет сам.
  • GEMINI_API_KEY — ваш ключ TeamoRouter.
  • GEMINI_API_KEY_AUTH_MECHANISM=bearer — Gemini CLI передаёт ключ в заголовке Authorization: Bearer, а не только в заголовке Google x-goog-api-key.

Мы проверили эту настройку 3 ноября 2026 года на Gemini CLI 0.66.0: запросы уходят на https://api.teamorouter.com/v1beta/models/<модель>:streamGenerateContent, и с тестовым ключом шлюз отвечает ошибкой 401 о неверном ключе — значит, адрес и формат запросов правильные.

Шаг 3. Первый запуск

Перейдите в папку проекта и запустите:

bash
gemini
  1. Программа спросит «Do you trust the files in this folder?». Выберите «Trust folder (...)». Если выбрать «Don't trust», Gemini CLI не прочитает ключ из ~/.gemini/.env в этой папке.
  2. Затем — экран выбора входа с вариантами «Sign in with Google», «Use Gemini API Key» и «Vertex AI». Выберите Use Gemini API Key и нажмите Enter.

По умолчанию Gemini CLI работает на модели gemini-3.1-pro-preview, а для коротких служебных запросов использует gemini-3.5-flash-lite. Обе есть в TeamoRouter, так что всё заработает без дополнительных настроек. Другую модель можно выбрать флагом -m или переменной GEMINI_MODEL в том же файле .env:

bash
gemini -m gemini-4-argon
Модель ID
Gemini 3.1 Pro Preview (по умолчанию) gemini-3.1-pro-preview
Gemini 4 Argon gemini-4-argon
Gemini 3.8 Flash gemini-3.8-flash

Подробнее о Gemini 4 Argon — в статье «Gemini 4 Argon через API из России».

Для скриптов есть режим без интерфейса: gemini -p "ваш вопрос".

Сколько это стоит

Сама программа бесплатна, а работа моделей оплачивается по токенам: подписки нет, вы платите только за то, что модель прочитала и написала. Актуальные цены всех моделей Gemini — на странице цен.

Как оплатить из России

Баланс пополняется в консоли, списание — только за фактически использованные токены; минимального пакета и «сгорающих» тарифов нет.

  • Рубли — в окне пополнения выберите способ справа на кнопке «Оплатить» — СБП, Т-Банк, ЮMoney или SberPay — и нажмите на кнопку. Платёж проводит платёжный сервис Payssion. Минимальное пополнение — $5. Если платёж не проходит, под кнопкой есть контакты поддержки — Telegram @teamorouter.
  • USDT, USDC или ETH — кнопка «Оплатить криптовалютой» в том же окне; этот способ выручает, если платёж в рублях не прошёл. Откроется страница оплаты: выберите монету и сеть и переведите средства с Binance, OKX или другой биржи либо из любого кошелька. Расширение не нужно, оплатить можно и с телефона; минимум — $5 (USDT в сети BEP20), счёт действует 60 минут. Пошагово — в статье «Как оплатить Claude API в USDT».

Частые ошибки

Первые три мы воспроизвели на Gemini CLI 0.66.0 и шлюзе TeamoRouter 3 ноября 2026 года.

The provided x-goog-api-key is invalid or expired. (401) Ключ дошёл до TeamoRouter, но не подошёл. Чаще всего он скопирован не полностью или с пробелом, либо удалён в консоли. Создайте новый ключ и вставьте его в GEMINI_API_KEY целиком.

No gateway route matched this request path. (404) В GOOGLE_GEMINI_BASE_URL на конце стоит /v1 или другой путь. Адрес должен быть ровно https://api.teamorouter.com.

Invalid auth method selected. Так отвечает режим gemini -p, если способ входа ещё не выбран. Один раз запустите gemini без флагов и выберите «Use Gemini API Key».

User location is not supported for the API use. Gemini CLI пошёл не в TeamoRouter, а напрямую к Google — значит, он не прочитал GOOGLE_GEMINI_BASE_URL. Частые причины: вы выбрали «Don't trust» для папки проекта; в папке проекта (или выше) лежит свой файл .env — Gemini CLI берёт первый найденный .env и до ~/.gemini/.env не доходит; на Windows вы не открыли терминал заново после setx.

402 и wallet balance is insufficient Баланс пуст. Пополните его от $5 и повторите запрос.

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

Как установить Gemini CLI в России? Поставьте Node.js 20 или новее и выполните npm install -g @google/gemini-cli (на macOS и Linux можно brew install gemini-cli). Пакет из npm скачивается из России без ограничений.

Можно ли войти через аккаунт Google? Нет, и не только из России: с 18 июня 2026 года Google отключил вход через Google для бесплатных аккаунтов Gemini Code Assist, Google AI Pro и Ultra в Gemini CLI. Подписки Gemini Code Assist Standard и Enterprise Google отключает по отдельному графику.

Нужен ли VPN? Нет. Gemini CLI обращается к api.teamorouter.com, а не к серверам Google, и аккаунт Google не нужен.

Это те же модели Gemini, что у Google? Да: запросы уходят к моделям Gemini по тем же идентификаторам, например gemini-3.1-pro-preview.

Можно ли пользоваться Gemini CLI бесплатно? Сама программа бесплатна и открыта, а работа моделей оплачивается по токенам. Пополнение — от $5.

Чем это отличается от Antigravity CLI? Antigravity — линейка продуктов, на которую Google предлагает перейти владельцам бесплатных и личных аккаунтов после отключения входа через Google. Gemini CLI при этом продолжает обновляться и работает с ключом API.

Что дальше

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.