Si al intentar iniciar sesión en Gemini CLI o usar la extensión Gemini Code Assist en VS Code ves un error como FAILED_PRECONDITION: User location is not supported — no es un problema con tu cuenta ni con el código. Google AI Studio y Gemini API se implementan en los países de manera desigual, y algunas regiones simplemente están excluidas de la lista de soportadas. Esto se soluciona configurando un proxy con una dirección IP de un país permitido — y a continuación veremos cómo hacerlo correctamente en la terminal, en VS Code y a nivel de variables de entorno.
Qué es Gemini CLI y Gemini Code Assist
Gemini CLI es una herramienta de consola de Google que permite interactuar con los modelos de Gemini directamente desde la terminal: escribir código, generar comandos, analizar archivos de proyecto y realizar tareas de agente sin salir del entorno de trabajo. Se conecta a la API en los dominios generativelanguage.googleapis.com o a través de Vertex AI, dependiendo de qué método de autorización utilices — clave de Google AI Studio o cuenta de Google Cloud.
Gemini Code Assist es una extensión para VS Code (así como para JetBrains IDE) que integra sugerencias, autocompletado y chat con el modelo directamente en el editor de código. Es esencialmente la misma API, pero invocada desde la IDE a través de la extensión, no desde la línea de comandos. Ambas herramientas utilizan el mismo backend, por lo que el problema del bloqueo regional se manifiesta de la misma manera en ambos casos: la extensión simplemente no puede establecer una sesión o devuelve un error en la primera solicitud al modelo.
Un matiz importante: ambas herramientas realizan solicitudes de red no solo a la API de generación, sino también a los servicios de autorización de Google (OAuth, Identity Toolkit). Si el proxy está configurado solo para un endpoint, la autorización puede pasar, pero la generación no, o viceversa. Por lo tanto, el proxy debe definirse a nivel de variables de entorno del sistema, no solo en un lugar específico.
Por qué Gemini no está disponible en tu región
Google tradicionalmente lanza nuevos productos de IA en etapas: primero en EE. UU. y parte de Europa, luego en el resto de los países. Para Gemini, esto se traduce en restricciones geográficas a nivel de API: el servidor verifica la dirección IP de la solicitud entrante (y a veces la dirección de facturación de la cuenta de Google) y la compara con la lista de ubicaciones permitidas. Si el país no está en la lista, la solicitud se interrumpe con un error de precondición o simplemente se agota sin una explicación clara.
Esto no es un bloqueo en el sentido habitual de la palabra: el proveedor de tu país no está cortando nada, se trata de un geo-filtro del lado de Google. Por lo tanto, un VPN con una IP compartida a menudo no ayuda: tales direcciones son utilizadas masivamente por miles de personas, Google las marca como sospechosas y o bien requiere un captcha, o corta la conexión por geo si el rango de IP está formalmente registrado en un país no permitido. Se necesita una dirección que parezca una IP doméstica o móvil normal de una región soportada — es decir, la tarea es exactamente la misma que la que resuelven los proxies residenciales y móviles.
Qué proxy elegir para trabajar con Gemini API
Para herramientas de desarrollo como Gemini CLI, los parámetros clave del proxy son la estabilidad de la sesión (para que la conexión no se interrumpa en medio de la generación de una respuesta larga), la velocidad y cuán "limpia" parece la IP para los sistemas anti-bot de Google. Aquí hay una comparación de tres tipos:
| Tipo de proxy | Velocidad | Riesgo de bloqueo geográfico | Cuándo usar |
|---|---|---|---|
| Proxies de centros de datos | Alta | Medio-alto | Pruebas rápidas, solicitudes únicas a la API |
| Proxies residenciales | Media-alta | Bajo | Trabajo diario con Gemini CLI y Code Assist |
| Proxies móviles | Media | Mínimo | Cuando la IP residencial es bloqueada por el geo-filtro |
En la práctica, para el trabajo diario de un desarrollador, los proxies residenciales con vinculación a un país específico y preferiblemente con una sesión sticky de 10-30 minutos son lo más conveniente — esto es suficiente para que la autorización OAuth no se interrumpa y la sesión de la terminal no se caiga en medio de la generación de código. Los proxies de centros de datos son más baratos y rápidos, pero algunos rangos de Google ya los conocen y a veces piden una verificación adicional de la cuenta al ingresar a través de tal IP. Es recomendable tener proxies móviles como respaldo — si la dirección residencial por alguna razón entra en la lista de sospechosos, la red móvil del operador generalmente pasa la verificación geográfica sin problemas.
Configuración del proxy en la terminal: Linux, macOS, Windows
Gemini CLI, como la mayoría de las utilidades de consola en Node.js (y está escrito en este), respeta las variables de entorno estándar HTTP_PROXY y HTTPS_PROXY. Esto es suficiente para enrutar todo el tráfico de CLI a través del proxy sin modificar la configuración de la aplicación.
Para macOS y Linux (bash/zsh), añade a la sesión actual:
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
Para que el proxy se aplique de forma permanente, y no solo en la sesión actual de la terminal, añade estas mismas líneas a ~/.zshrc o ~/.bashrc y reinicia la terminal con el comando source ~/.zshrc.
Para Windows en PowerShell, las variables se establecen así:
$env:HTTP_PROXY = "http://login:password@proxy_host:port"
$env:HTTPS_PROXY = "http://login:password@proxy_host:port"
gemini --version
Si deseas que las variables se mantengan después de reiniciar PowerShell, utiliza [System.Environment]::SetEnvironmentVariable("HTTPS_PROXY", "http://login:password@proxy_host:port", "User") — la variable se registrará en el perfil de usuario de Windows.
Si tu proxy requiere una autorización separada sin login en la URL (por ejemplo, mediante una lista blanca de IP), simplemente quita el login y la contraseña de la cadena de conexión y añade la IP de tu servidor o máquina de trabajo a la lista blanca en el panel del proveedor de proxy.
Configuración del proxy en VS Code para Code Assist
VS Code tiene su propia configuración de proxy, que no se hereda automáticamente de las variables de entorno del sistema, a menos que se habilite la opción correspondiente. Abre settings.json (Ctrl+Shift+P → "Preferences: Open User Settings (JSON)") y añade:
{
"http.proxy": "http://login:password@proxy_host:port",
"http.proxyStrictSSL": false,
"http.proxySupport": "override"
}
El parámetro http.proxySupport: "override" es importante: sin él, VS Code puede seguir utilizando el proxy del sistema o ignorar la configuración para extensiones individuales. Después de modificar la configuración, reinicia completamente VS Code (no solo recargues la ventana), porque la extensión Gemini Code Assist inicializa el cliente de red una vez al iniciar la aplicación.
Si la extensión aún no ve el proxy, verifica la configuración de http.proxyAuthorization — en raras ocasiones, las versiones corporativas de VS Code bloquean el envío de login y contraseña en la URL del proxy por razones de seguridad, y en ese caso las credenciales deben enviarse a través del encabezado Proxy-Authorization en base64.
Un punto adicional — desactiva temporalmente las herramientas de diagnóstico como los clientes VPN corporativos y los antivirus que interceptan el tráfico (inspección SSL). A menudo sustituyen el certificado sobre la marcha, y Gemini Code Assist, que verifica estrictamente la cadena de certificados de Google, romperá la conexión con un error TLS, que puede confundirse fácilmente con un problema del propio proxy.
Configuración del proxy en Gemini CLI
Además de las variables de entorno, en Gemini CLI se puede establecer un proxy a través del archivo de configuración del proyecto o de las configuraciones globales del usuario — esto es conveniente si deseas usar diferentes proxies para diferentes proyectos sin tocar las variables del sistema. La configuración generalmente se almacena en ~/.gemini/settings.json o en un archivo .env dentro del directorio del proyecto:
# .env en la raíz del proyecto
GEMINI_API_KEY=tu_clave
HTTPS_PROXY=http://login:password@proxy_host:port
HTTP_PROXY=http://login:password@proxy_host:port
Si te autenticas a través de una cuenta de Google Cloud (Vertex AI), en lugar de a través de una clave de AI Studio, también necesitarás que el proxy sea utilizado por la herramienta gcloud, a través de la cual pasa el flujo de OAuth. Para ello, el proxy se establece por separado:
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
Si después de esto gcloud auth login aún abre el navegador con la IP real (no proxy) para confirmar el inicio de sesión, ten en cuenta: la propia página de OAuth se abre en tu navegador del sistema directamente, y si el navegador no está configurado para el mismo proxy, la sesión de autorización final puede recibir un token vinculado a tu IP real. Para una coherencia total, es recomendable configurar el proxy también en el navegador que utilizas para confirmar el inicio de sesión — por ejemplo, a través de una extensión de proxy o configuraciones de red del sistema durante la autorización.
Verificación de conexión: curl y Python
Antes de investigar por qué no funciona específicamente Gemini CLI, asegúrate de que el proxy, en general, está pasando el tráfico a la API de Google. La forma más rápida es hacer una solicitud directa a través de curl:
curl -x http://login:password@proxy_host:port \
"https://generativelanguage.googleapis.com/v1beta/models?key=TU_API_KEY"
Si recibes un JSON con la lista de modelos (gemini-1.5-flash, gemini-1.5-pro, etc.) — el proxy está funcionando y la región es soportada. Si ves 403 o FAILED_PRECONDITION — hay un problema a nivel de geo-filtro, es necesario cambiar el país del proxy.
Para un diagnóstico más detallado, es conveniente usar Python especificando explícitamente el proxy para la sesión:
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": "TU_API_KEY"}
response = requests.get(url, params=params, proxies=proxies, timeout=15)
print(response.status_code)
print(response.text[:500])
Este script es útil tenerlo a mano como una verificación rápida antes de iniciar una sesión completa en CLI o en la IDE — muestra en segundos si el problema es de la red, la clave o la región de la IP.
Errores comunes y su solución
Error "User location is not supported" incluso después de conectar el proxy generalmente significa que la IP del servidor proxy está en un país no soportado o que Google la ha identificado como de centro de datos y ha aplicado una verificación adicional. La solución es cambiar a una IP residencial o móvil de EE. UU. u otro país con soporte completo para Gemini.
Time-outs al generar respuestas largas suelen estar relacionados con una sesión inestable del proxy — la IP cambia en medio de la solicitud y la conexión se interrumpe. Se necesita una sesión sticky durante un tiempo que supere la duración típica de la solicitud (generalmente 10-15 minutos de margen es suficiente incluso para grandes generaciones de código).
Error SSL/TLS handshake failed casi siempre indica la interceptación del tráfico por un antivirus, un firewall corporativo o una configuración incorrecta de proxyStrictSSL en VS Code. Verifica si hay software con inspección SSL en la máquina y desactívalo temporalmente para diagnóstico.
CLI funciona, pero la extensión en VS Code no (o viceversa) significa que las variables de entorno no se han transferido al proceso de VS Code. Esta es una situación común en Linux y macOS, si VS Code se inicia no desde la terminal donde se exportaron las variables, sino desde un icono en el menú del sistema. En tal caso, las variables deben establecerse a través de settings.json, como se describió anteriormente, y no confiar en la herencia desde el shell.
Vinculación de IP a la región de la clave API y seguridad
Un matiz separado que a menudo se olvida: si la clave API o el proyecto de Google Cloud se creó vinculado a una región de facturación específica, cambiar la IP del proxy puede llevar a una discrepancia entre la ubicación esperada y la real, y Google a veces requiere una nueva verificación a través de SMS o correo electrónico. Para reducir la frecuencia de tales verificaciones, intenta utilizar proxies con una IP constante (no rotativa en cada solicitud) de un mismo país — esto se ve para los sistemas de protección de Google como un comportamiento normal de un usuario que simplemente vive en ese país, y no como una actividad sospechosa.
Si trabajas con varios proyectos o claves al mismo tiempo y utilizas un navegador anti-detección como Dolphin Anty o AdsPower para aislar perfiles (relevante si pruebas integraciones de Gemini en diferentes entornos de navegador), vincula a cada perfil un proxy separado con geolocalización fija — así hay menos riesgo de que un proyecto "arrastre" sospechas debido a las IP mezcladas de otro.
También es recomendable no usar el mismo proxy gratuito o compartido para Gemini y al mismo tiempo para otras tareas de alta carga — un gran número de sesiones paralelas desde una misma IP aumenta la posibilidad de caer bajo un límite de tasa o bloqueo temporal a nivel de Google, lo que se ve igual que un problema con la región, aunque la causa sea completamente diferente.
Conclusión
La limitación de Gemini CLI y Gemini Code Assist por región se resuelve a nivel de red: el proxy debe configurarse simultáneamente en las variables de entorno del sistema, en la configuración de VS Code y, al usar Google Cloud, en la configuración de gcloud — solo entonces los tres puntos de entrada (CLI, extensión IDE y autorización OAuth) funcionarán a través de la misma IP sin desincronización. Antes de trabajar plenamente, siempre verifica la conexión con una simple solicitud curl — esto ahorra horas en diagnóstico, cuando el problema en realidad no está en el código, sino en el país del proxy.
Para un trabajo diario estable con Gemini CLI, los proxies residenciales con geolocalización fija y una larga sesión sticky son los más adecuados — parecen una IP doméstica normal y rara vez provocan verificaciones adicionales de Google. Si la dirección residencial aún cae bajo el geo-filtro, vale la pena probar los proxies móviles, y para pruebas rápidas únicas de la API sin una larga sesión, son suficientes los proxies de centros de datos.