Если при попытке авторизоваться в Gemini CLI или использовать расширение Gemini Code Assist в VS Code вы видите ошибку вроде FAILED_PRECONDITION: User location is not supported — дело не в вашем аккаунте и не в коде. Google AI Studio и Gemini API раскатываются по странам неравномерно, и часть регионов просто исключена из списка поддерживаемых. Решается это настройкой прокси с IP-адресом из разрешённой страны — и дальше мы разберём, как сделать это правильно в терминале, в VS Code и на уровне переменных окружения.
Что такое Gemini CLI и Gemini Code Assist
Gemini CLI — это консольный инструмент Google, который позволяет общаться с моделями Gemini прямо из терминала: писать код, генерировать команды, анализировать файлы проекта и выполнять агентные задачи без выхода из рабочей среды. Он обращается к API на доменах generativelanguage.googleapis.com или через Vertex AI, в зависимости от того, какой способ авторизации вы используете — ключ Google AI Studio или аккаунт Google Cloud.
Gemini Code Assist — это расширение для VS Code (а также для JetBrains IDE), которое встраивает подсказки, автодополнение и чат с моделью прямо в редактор кода. По сути это тот же API, но вызываемый из IDE через расширение, а не из командной строки. Оба инструмента используют один и тот же бэкенд, поэтому проблема региональной блокировки проявляется одинаково в обоих случаях — расширение просто не может установить сессию или возвращает ошибку при первом запросе к модели.
Важный нюанс: оба инструмента делают сетевые запросы не только к самому API генерации, но и к сервисам авторизации Google (OAuth, Identity Toolkit). Если прокси настроен только для одного эндпоинта, авторизация может пройти, а генерация — нет, или наоборот. Поэтому прокси нужно прописывать на уровне системных переменных окружения, а не точечно в одном месте.
Почему Gemini недоступен в вашем регионе
Google традиционно раскатывает новые AI-продукты поэтапно: сначала США и часть Европы, затем остальные страны. Для Gemini это выражается в географических ограничениях на уровне API — сервер проверяет IP-адрес входящего запроса (а иногда и биллинг-адрес аккаунта Google) и сравнивает со списком разрешённых локаций. Если страна не в списке, запрос обрывается с ошибкой precondition или просто таймаутится без внятного объяснения.
Это не блокировка в привычном смысле слова — провайдер вашей страны ничего не режет, речь именно о гео-фильтре на стороне Google. Соответственно, VPN с общим IP часто не спасает: такие адреса массово используются тысячами людей, Google их маркирует как подозрительные и либо требует капчу, либо всё равно режет по гео, если диапазон IP формально зарегистрирован не в той стране. Нужен адрес, который выглядит как обычный домашний или мобильный IP из поддерживаемого региона — то есть задача ровно та же, что решают резидентные и мобильные прокси.
Какой прокси выбрать для работы с Gemini API
Для разработческих инструментов вроде Gemini CLI ключевые параметры прокси — это стабильность сессии (чтобы не рвалось соединение посреди генерации длинного ответа), скорость и то, насколько «чистым» выглядит IP для систем антифрода Google. Вот сравнение трёх типов:
| Тип прокси | Скорость | Риск гео-блокировки | Когда использовать |
|---|---|---|---|
| Прокси дата-центров | Высокая | Средний-высокий | Быстрые тесты, разовые запросы к API |
| Резидентные прокси | Средняя-высокая | Низкий | Ежедневная работа с Gemini CLI и Code Assist |
| Мобильные прокси | Средняя | Минимальный | Когда резидентный IP всё равно режется гео-фильтром |
На практике для ежедневной работы разработчика удобнее всего резидентные прокси с привязкой к конкретной стране и желательно с sticky-сессией на 10-30 минут — этого достаточно, чтобы не обрывалась авторизация OAuth и не слетала сессия терминала посреди генерации кода. Датацентровые прокси дешевле и быстрее, но часть диапазонов Google уже знает и иногда просит дополнительную верификацию аккаунта при входе через такой IP. Мобильные прокси стоит держать про запас — если резидентный адрес почему-то попал в список подозрительных, мобильная сеть оператора обычно проходит проверку гео без вопросов.
Настройка прокси в терминале: Linux, macOS, Windows
Gemini CLI, как и большинство консольных утилит на Node.js (а он написан именно на нём), уважает стандартные переменные окружения HTTP_PROXY и HTTPS_PROXY. Этого достаточно, чтобы завернуть весь трафик CLI через прокси без правки конфигов приложения.
Для macOS и Linux (bash/zsh) добавьте в текущую сессию:
export HTTP_PROXY="http://login:password@proxy_host:port"
export HTTPS_PROXY="http://login:password@proxy_host:port"
export NO_PROXY="localhost,127.0.0.1"
gemini --version
Чтобы прокси применялся постоянно, а не только в текущей сессии терминала, добавьте эти же строки в ~/.zshrc или ~/.bashrc и перезапустите терминал командой source ~/.zshrc.
Для Windows в PowerShell переменные задаются так:
$env:HTTP_PROXY = "http://login:password@proxy_host:port"
$env:HTTPS_PROXY = "http://login:password@proxy_host:port"
gemini --version
Если хотите, чтобы переменные сохранялись после перезапуска PowerShell, используйте [System.Environment]::SetEnvironmentVariable("HTTPS_PROXY", "http://login:password@proxy_host:port", "User") — переменная запишется в пользовательский профиль Windows.
Если ваш прокси требует отдельной авторизации без логина в URL (например, по IP whitelist), просто уберите логин и пароль из строки подключения и добавьте IP вашего сервера или рабочей машины в白list на стороне панели прокси-провайдера.
Настройка прокси в VS Code для Code Assist
VS Code имеет собственные настройки прокси, которые не наследуются автоматически из переменных окружения системы, если не включена соответствующая опция. Откройте settings.json (Ctrl+Shift+P → "Preferences: Open User Settings (JSON)") и добавьте:
{
"http.proxy": "http://login:password@proxy_host:port",
"http.proxyStrictSSL": false,
"http.proxySupport": "override"
}
Параметр http.proxySupport: "override" важен: без него VS Code может продолжать использовать системный прокси или вообще игнорировать настройку для отдельных расширений. После правки настроек перезапустите VS Code полностью (не просто перезагрузите окно), потому что расширение Gemini Code Assist инициализирует сетевой клиент один раз при старте приложения.
Если расширение всё равно не видит прокси, проверьте настройку http.proxyAuthorization — в редких случаях корпоративные сборки VS Code блокируют передачу логина и пароля в URL прокси из соображений безопасности, и тогда креды нужно передавать через заголовок Proxy-Authorization в base64.
Отдельный момент — выключите на время диагностики расширения вроде корпоративных VPN-клиентов и антивирусов с перехватом трафика (SSL-инспекция). Они часто подменяют сертификат на лету, и Gemini Code Assist, строго проверяющий цепочку сертификатов Google, будет рвать соединение с ошибкой TLS, которую легко спутать с проблемой самого прокси.
Настройка прокси в самом Gemini CLI
Помимо переменных окружения, в Gemini CLI можно задать прокси через файл конфигурации проекта или глобальных настроек пользователя — это удобно, если вы хотите использовать разные прокси для разных проектов, не трогая системные переменные. Конфиг обычно хранится в ~/.gemini/settings.json или в файле .env внутри директории проекта:
# .env в корне проекта
GEMINI_API_KEY=ваш_ключ
HTTPS_PROXY=http://login:password@proxy_host:port
HTTP_PROXY=http://login:password@proxy_host:port
Если вы авторизуетесь через Google Cloud аккаунт (Vertex AI), а не через ключ AI Studio, дополнительно потребуется, чтобы прокси использовался и утилитой gcloud, через которую проходит OAuth-флоу. Для неё прокси задаётся отдельно:
gcloud config set proxy/type http
gcloud config set proxy/address proxy_host
gcloud config set proxy/port port
gcloud config set proxy/username login
gcloud config set proxy/password password
Если после этого gcloud auth login всё равно открывает браузер с реальным (не проксированным) IP для подтверждения входа, учтите: сама OAuth-страница открывается в вашем системном браузере напрямую, и если браузер не настроен на тот же прокси, итоговая сессия авторизации может получить токен с привязкой к вашему настоящему IP. Для полной согласованности стоит настраивать прокси и в браузере, которым подтверждаете вход — например, через расширение прокси или системные настройки сети на время авторизации.
Проверка подключения: curl и Python
Прежде чем разбираться, почему не работает именно Gemini CLI, убедитесь, что прокси в принципе пробрасывает трафик до API Google. Самый быстрый способ — прямой запрос через curl:
curl -x http://login:password@proxy_host:port \
"https://generativelanguage.googleapis.com/v1beta/models?key=ВАШ_API_KEY"
Если в ответ приходит JSON со списком моделей (gemini-1.5-flash, gemini-1.5-pro и так далее) — прокси рабочий и регион поддерживается. Если видите 403 или FAILED_PRECONDITION — проблема на уровне гео-фильтра, нужно менять страну прокси.
Для более детальной диагностики удобно использовать Python с явным указанием прокси для сессии:
import requests
proxies = {
"http": "http://login:password@proxy_host:port",
"https": "http://login:password@proxy_host:port",
}
url = "https://generativelanguage.googleapis.com/v1beta/models"
params = {"key": "ВАШ_API_KEY"}
response = requests.get(url, params=params, proxies=proxies, timeout=15)
print(response.status_code)
print(response.text[:500])
Такой скрипт удобно держать под рукой как быструю проверку перед запуском полноценной сессии в CLI или в IDE — он за пару секунд показывает, виновата ли сеть, ключ или сам регион IP.
Частые ошибки и их решение
Ошибка "User location is not supported" даже после подключения прокси обычно означает, что IP прокси-сервера либо находится в неподдерживаемой стране, либо Google определил его как дата-центровый и применил дополнительную проверку. Решение — переключиться на резидентный или мобильный IP из США или другой страны с полной поддержкой Gemini.
Таймауты при генерации длинных ответов чаще всего связаны с нестабильной сессией прокси — IP меняется посреди запроса, и соединение обрывается. Нужна sticky-сессия на время, превышающее типичный запрос (обычно 10-15 минут с запасом хватает даже для объёмных генераций кода).
Ошибка SSL/TLS handshake failed почти всегда указывает на перехват трафика антивирусом, корпоративным файрволом или неправильно настроенным proxyStrictSSL в VS Code. Проверьте, не стоит ли на машине ПО с SSL-инспекцией, и временно отключите его для диагностики.
CLI работает, а расширение в VS Code — нет (или наоборот) означает, что переменные окружения не прокинуты в процесс VS Code. Это частая ситуация в Linux и macOS, если VS Code запущен не из того терминала, где экспортированы переменные, а из иконки в системном меню. В таком случае переменные нужно задавать именно через settings.json, как описано выше, а не рассчитывать на наследование из shell.
Привязка IP к региону API-ключа и безопасность
Отдельная тонкость, о которой часто забывают: если API-ключ или проект Google Cloud был создан с привязкой к конкретному биллинг-региону, смена IP прокси может приводить к несовпадению ожидаемой и фактической локации, и Google иногда требует повторную верификацию через SMS или email. Чтобы снизить частоту таких проверок, старайтесь использовать прокси с постоянным (не ротируемым на каждый запрос) IP из одной и той же страны — это выглядит для систем защиты Google как обычное поведение пользователя, который просто живёт в этой стране, а не как подозрительная активность.
Если вы работаете с несколькими проектами или ключами одновременно и используете антидетект-браузер вроде Dolphin Anty или AdsPower для изоляции профилей (актуально, если тестируете интеграции Gemini в разных браузерных окружениях), привязывайте к каждому профилю отдельный прокси с фиксированной геолокацией — так меньше риска, что один проект "утянет" за собой подозрения из-за смешанных IP другого.
Также не стоит использовать один и тот же бесплатный или общий прокси для Gemini и одновременно для других задач с высокой нагрузкой — большое количество параллельных сессий с одного IP повышает шанс попасть под rate-limit или временную блокировку на уровне Google, что выглядит так же, как проблема с регионом, хотя причина совершенно другая.
Заключение
Ограничение Gemini CLI и Gemini Code Assist по региону решается на сетевом уровне: прокси нужно прописать одновременно в переменных окружения системы, в настройках VS Code и, при использовании Google Cloud, в конфиге gcloud — только тогда все три точки входа (CLI, IDE-расширение и OAuth-авторизация) будут работать через один и тот же IP без рассинхрона. Перед полноценной работой всегда проверяйте соединение простым curl-запросом — это экономит часы на диагностике, когда проблема на самом деле не в коде, а в стране прокси.
Для стабильной ежедневной работы с Gemini CLI лучше всего подходят резидентные прокси с фиксированной геолокацией и длительной sticky-сессией — они выглядят как обычный домашний IP и редко вызывают дополнительные проверки Google. Если резидентный адрес всё же попадает под гео-фильтр, стоит попробовать мобильные прокси, а для быстрых разовых тестов API без долгой сессии вполне хватит прокси дата-центров.