← Retour au blog

Proxies pour Gemini CLI et VS Code Code Assist : accès depuis une région sans support Google

Instructions étape par étape pour configurer un proxy HTTP/HTTPS pour Gemini CLI et l'extension Gemini Code Assist dans VS Code, si votre région n'est pas prise en charge par Google.

📅14 novembre 2026

Si lors de votre tentative de vous connecter à Gemini CLI ou d'utiliser l'extension Gemini Code Assist dans VS Code, vous voyez une erreur comme FAILED_PRECONDITION: User location is not supported — ce n'est pas un problème avec votre compte ou votre code. Google AI Studio et Gemini API sont déployés de manière inégale dans les pays, et certaines régions sont simplement exclues de la liste des régions prises en charge. Cela peut être résolu en configurant un proxy avec une adresse IP d'un pays autorisé — et nous allons voir comment faire cela correctement dans le terminal, dans VS Code et au niveau des variables d'environnement.

Qu'est-ce que Gemini CLI et Gemini Code Assist

Gemini CLI est un outil en ligne de commande de Google qui permet d'interagir avec les modèles Gemini directement depuis le terminal : écrire du code, générer des commandes, analyser des fichiers de projet et exécuter des tâches d'agent sans quitter l'environnement de travail. Il accède à l'API sur les domaines generativelanguage.googleapis.com ou via Vertex AI, selon la méthode d'authentification que vous utilisez — clé Google AI Studio ou compte Google Cloud.

Gemini Code Assist est une extension pour VS Code (et également pour JetBrains IDE) qui intègre des suggestions, de l'autocomplétion et un chat avec le modèle directement dans l'éditeur de code. En gros, c'est la même API, mais appelée depuis l'IDE via l'extension, et non depuis la ligne de commande. Les deux outils utilisent le même backend, donc le problème de blocage régional se manifeste de la même manière dans les deux cas — l'extension ne peut tout simplement pas établir de session ou renvoie une erreur lors de la première requête au modèle.

Un point important : les deux outils effectuent des requêtes réseau non seulement vers l'API de génération elle-même, mais aussi vers les services d'authentification de Google (OAuth, Identity Toolkit). Si le proxy est configuré uniquement pour un seul point de terminaison, l'authentification peut réussir, mais la génération peut échouer, ou vice versa. Par conséquent, le proxy doit être configuré au niveau des variables d'environnement système, et non de manière ponctuelle à un seul endroit.

Pourquoi Gemini n'est-il pas disponible dans votre région

Google déploie traditionnellement de nouveaux produits AI par étapes : d'abord aux États-Unis et dans certaines parties de l'Europe, puis dans d'autres pays. Pour Gemini, cela se traduit par des restrictions géographiques au niveau de l'API — le serveur vérifie l'adresse IP de la requête entrante (et parfois l'adresse de facturation du compte Google) et la compare à la liste des emplacements autorisés. Si le pays n'est pas sur la liste, la requête est interrompue avec une erreur de précondition ou expire simplement sans explication claire.

Ce n'est pas un blocage au sens habituel du terme — le fournisseur de votre pays ne bloque rien, il s'agit d'un filtre géographique du côté de Google. Par conséquent, un VPN avec une IP partagée ne sauve souvent pas la situation : de telles adresses sont massivement utilisées par des milliers de personnes, Google les marque comme suspectes et exige soit un captcha, soit bloque quand même par géo si la plage IP est formellement enregistrée dans un autre pays. Vous avez besoin d'une adresse qui ressemble à une IP domestique ou mobile ordinaire d'une région prise en charge — c'est-à-dire que la tâche est exactement la même que celle que résolvent les proxies résidentiels et mobiles.

Quel proxy choisir pour travailler avec Gemini API

Pour des outils de développement comme Gemini CLI, les paramètres clés du proxy sont la stabilité de la session (pour ne pas perdre la connexion au milieu de la génération d'une longue réponse), la vitesse et à quel point l'IP semble « propre » pour les systèmes anti-fraude de Google. Voici une comparaison de trois types :

Type de proxy Vitesse Risque de blocage géographique Quand utiliser
Proxies de centre de données Élevée Moyenne-élevée Tests rapides, requêtes ponctuelles à l'API
Proxies résidentiels Moyenne-élevée Faible Travail quotidien avec Gemini CLI et Code Assist
Proxies mobiles Moyenne Minimale Lorsque l'IP résidentielle est bloquée par le filtre géographique

En pratique, pour le travail quotidien des développeurs, les proxies résidentiels avec une liaison à un pays spécifique et de préférence avec une session sticky de 10 à 30 minutes sont les plus pratiques — cela suffit pour que l'authentification OAuth ne soit pas interrompue et que la session du terminal ne soit pas perdue au milieu de la génération de code. Les proxies de centre de données sont moins chers et plus rapides, mais certaines plages d'adresses IP sont déjà connues de Google et demandent parfois une vérification supplémentaire du compte lors de la connexion via une telle IP. Il est conseillé de garder des proxies mobiles en réserve — si l'adresse résidentielle est soudainement marquée comme suspecte, le réseau mobile de l'opérateur passe généralement le contrôle géographique sans problème.

Configuration du proxy dans le terminal : Linux, macOS, Windows

Gemini CLI, comme la plupart des utilitaires en ligne de commande sur Node.js (qui est exactement ce sur quoi il est écrit), respecte les variables d'environnement standard HTTP_PROXY et HTTPS_PROXY. Cela suffit pour acheminer tout le trafic CLI via le proxy sans modifier les configurations de l'application.

Pour macOS et Linux (bash/zsh), ajoutez à la session actuelle :

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

Pour que le proxy soit appliqué en permanence et pas seulement dans la session actuelle du terminal, ajoutez ces mêmes lignes dans ~/.zshrc ou ~/.bashrc et redémarrez le terminal avec la commande source ~/.zshrc.

Pour Windows dans PowerShell, les variables sont définies comme suit :

$env:HTTP_PROXY = "http://login:password@proxy_host:port"
$env:HTTPS_PROXY = "http://login:password@proxy_host:port"

gemini --version

Si vous souhaitez que les variables soient conservées après le redémarrage de PowerShell, utilisez [System.Environment]::SetEnvironmentVariable("HTTPS_PROXY", "http://login:password@proxy_host:port", "User") — la variable sera enregistrée dans le profil utilisateur Windows.

Si votre proxy nécessite une authentification séparée sans login dans l'URL (par exemple, par liste blanche d'IP), il suffit de retirer le login et le mot de passe de la chaîne de connexion et d'ajouter l'IP de votre serveur ou machine de travail dans la liste blanche du panneau du fournisseur de proxy.

Configuration du proxy dans VS Code pour Code Assist

VS Code a ses propres paramètres de proxy qui ne sont pas hérités automatiquement des variables d'environnement du système, sauf si l'option correspondante est activée. Ouvrez settings.json (Ctrl+Shift+P → "Preferences: Open User Settings (JSON)") et ajoutez :

{
  "http.proxy": "http://login:password@proxy_host:port",
  "http.proxyStrictSSL": false,
  "http.proxySupport": "override"
}

Le paramètre http.proxySupport: "override" est important : sans lui, VS Code peut continuer à utiliser le proxy système ou ignorer complètement le paramètre pour certaines extensions. Après avoir modifié les paramètres, redémarrez complètement VS Code (pas seulement la fenêtre), car l'extension Gemini Code Assist initialise le client réseau une seule fois au démarrage de l'application.

Si l'extension ne voit toujours pas le proxy, vérifiez le paramètre http.proxyAuthorization — dans de rares cas, les versions d'entreprise de VS Code bloquent la transmission du login et du mot de passe dans l'URL du proxy pour des raisons de sécurité, et dans ce cas, les identifiants doivent être transmis via l'en-tête Proxy-Authorization en base64.

Un point distinct — désactivez temporairement les diagnostics d'extensions comme les clients VPN d'entreprise et les antivirus avec interception du trafic (inspection SSL). Ils remplacent souvent le certificat à la volée, et Gemini Code Assist, qui vérifie strictement la chaîne de certificats de Google, interrompra la connexion avec une erreur TLS, qui peut facilement être confondue avec un problème du proxy lui-même.

Configuration du proxy dans Gemini CLI

En plus des variables d'environnement, dans Gemini CLI, vous pouvez définir le proxy via un fichier de configuration de projet ou des paramètres globaux de l'utilisateur — c'est pratique si vous souhaitez utiliser différents proxies pour différents projets sans toucher aux variables système. La configuration est généralement stockée dans ~/.gemini/settings.json ou dans un fichier .env à l'intérieur du répertoire du projet :

# .env à la racine du projet
GEMINI_API_KEY=your_key
HTTPS_PROXY=http://login:password@proxy_host:port
HTTP_PROXY=http://login:password@proxy_host:port

Si vous vous authentifiez via un compte Google Cloud (Vertex AI) et non via une clé AI Studio, il est également nécessaire que le proxy soit utilisé par l'outil gcloud, à travers lequel passe le flux OAuth. Pour cela, le proxy est défini séparément :

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 après cela gcloud auth login ouvre toujours le navigateur avec l'IP réelle (non proxy) pour confirmer la connexion, gardez à l'esprit : la page OAuth elle-même s'ouvre directement dans votre navigateur système, et si le navigateur n'est pas configuré avec le même proxy, la session d'authentification finale peut obtenir un token lié à votre véritable IP. Pour une cohérence totale, il est préférable de configurer le proxy également dans le navigateur que vous utilisez pour confirmer la connexion — par exemple, via une extension de proxy ou les paramètres réseau système pendant l'authentification.

Vérification de la connexion : curl et Python

Avant de vous pencher sur la raison pour laquelle Gemini CLI ne fonctionne pas, assurez-vous que le proxy transmet bien le trafic vers l'API Google. Le moyen le plus rapide est de faire une requête directe via curl :

curl -x http://login:password@proxy_host:port \
  "https://generativelanguage.googleapis.com/v1beta/models?key=VOTRE_API_KEY"

Si vous recevez une réponse JSON avec la liste des modèles (gemini-1.5-flash, gemini-1.5-pro, etc.) — le proxy fonctionne et la région est prise en charge. Si vous voyez 403 ou FAILED_PRECONDITION — le problème est au niveau du filtre géographique, il faut changer le pays du proxy.

Pour un diagnostic plus détaillé, il est pratique d'utiliser Python avec une indication explicite du proxy pour la session :

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": "VOTRE_API_KEY"}

response = requests.get(url, params=params, proxies=proxies, timeout=15)
print(response.status_code)
print(response.text[:500])

Ce script est pratique à garder sous la main comme vérification rapide avant de lancer une session complète dans CLI ou dans IDE — il montre en quelques secondes si le problème vient du réseau, de la clé ou de la région IP elle-même.

Erreurs fréquentes et leurs solutions

Erreur "User location is not supported" même après la connexion du proxy signifie généralement que l'IP du serveur proxy est soit dans un pays non pris en charge, soit Google l'a identifié comme une IP de centre de données et a appliqué une vérification supplémentaire. La solution consiste à passer à une IP résidentielle ou mobile des États-Unis ou d'un autre pays avec un support complet de Gemini.

Timeout lors de la génération de longues réponses est souvent lié à une session proxy instable — l'IP change au milieu de la requête, et la connexion se coupe. Une session sticky est nécessaire pour un temps supérieur à la durée typique d'une requête (généralement 10-15 minutes avec une marge est suffisante même pour des générations de code volumineuses).

Erreur SSL/TLS handshake failed indique presque toujours une interception du trafic par un antivirus, un pare-feu d'entreprise ou une configuration incorrecte de proxyStrictSSL dans VS Code. Vérifiez si un logiciel avec inspection SSL est installé sur la machine et désactivez-le temporairement pour le diagnostic.

CLI fonctionne, mais l'extension dans VS Code ne fonctionne pas (ou vice versa) signifie que les variables d'environnement ne sont pas transmises au processus de VS Code. C'est une situation fréquente sous Linux et macOS, si VS Code est lancé depuis un autre terminal où les variables ont été exportées, plutôt que depuis l'icône du menu système. Dans ce cas, les variables doivent être définies via settings.json, comme décrit ci-dessus, et non s'attendre à un héritage depuis le shell.

Liaison IP à la région de la clé API et sécurité

Une nuance distincte, souvent oubliée : si la clé API ou le projet Google Cloud a été créé avec une liaison à une région de facturation spécifique, le changement d'IP du proxy peut entraîner un décalage entre l'emplacement attendu et l'emplacement réel, et Google exige parfois une nouvelle vérification par SMS ou email. Pour réduire la fréquence de telles vérifications, essayez d'utiliser des proxies avec une IP fixe (non rotative à chaque requête) d'un même pays — cela semble pour les systèmes de protection de Google comme un comportement normal d'un utilisateur vivant simplement dans ce pays, et non comme une activité suspecte.

Si vous travaillez sur plusieurs projets ou clés en même temps et utilisez un navigateur anti-détection comme Dolphin Anty ou AdsPower pour isoler les profils (pertinent si vous testez des intégrations Gemini dans différents environnements de navigateur), associez à chaque profil un proxy distinct avec une géolocalisation fixe — cela réduit le risque qu'un projet "attire" des soupçons en raison des IP mélangées d'un autre.

Il est également déconseillé d'utiliser le même proxy gratuit ou partagé pour Gemini et en même temps pour d'autres tâches à forte charge — un grand nombre de sessions parallèles depuis une seule IP augmente le risque de tomber sous un rate-limit ou un blocage temporaire au niveau de Google, ce qui ressemble à un problème de région, bien que la cause soit complètement différente.

Conclusion

La restriction de Gemini CLI et Gemini Code Assist par région est résolue au niveau réseau : le proxy doit être configuré simultanément dans les variables d'environnement système, dans les paramètres de VS Code et, lors de l'utilisation de Google Cloud, dans la configuration de gcloud — seulement alors, tous les trois points d'entrée (CLI, extension IDE et authentification OAuth) fonctionneront via la même IP sans désynchronisation. Avant de commencer à travailler pleinement, vérifiez toujours la connexion avec une simple requête curl — cela économise des heures de diagnostic lorsque le problème ne réside en réalité pas dans le code, mais dans le pays du proxy.

Pour un travail quotidien stable avec Gemini CLI, les proxies résidentiels avec une géolocalisation fixe et une session sticky prolongée sont les plus adaptés — ils ressemblent à une IP domestique ordinaire et provoquent rarement des vérifications supplémentaires de Google. Si l'adresse résidentielle est tout de même bloquée par le filtre géographique, il vaut la peine d'essayer des proxies mobiles, et pour des tests API rapides et ponctuels sans longue session, des proxies de centre de données suffisent amplement.