Wenn Sie beim Versuch, sich bei Gemini CLI anzumelden oder die Erweiterung Gemini Code Assist in VS Code zu verwenden, einen Fehler wie FAILED_PRECONDITION: User location is not supported sehen, liegt das nicht an Ihrem Konto oder dem Code. Google AI Studio und Gemini API werden ungleichmäßig in den Ländern ausgerollt, und einige Regionen sind einfach von der Liste der unterstützten ausgeschlossen. Dies kann durch die Einrichtung eines Proxys mit einer IP-Adresse aus einem unterstützten Land behoben werden — und im Folgenden werden wir erläutern, wie Sie dies richtig im Terminal, in VS Code und auf der Ebene der Umgebungsvariablen einrichten.
Was ist Gemini CLI und Gemini Code Assist
Gemini CLI ist ein Konsolenwerkzeug von Google, das es ermöglicht, direkt aus dem Terminal mit Gemini-Modellen zu interagieren: Code zu schreiben, Befehle zu generieren, Projektdateien zu analysieren und Agentenaufgaben zu erledigen, ohne die Arbeitsumgebung zu verlassen. Es greift auf die API unter den Domains generativelanguage.googleapis.com oder über Vertex AI zu, je nachdem, welche Authentifizierungsmethode Sie verwenden — den Google AI Studio-Schlüssel oder ein Google Cloud-Konto.
Gemini Code Assist ist eine Erweiterung für VS Code (sowie für JetBrains IDE), die Vorschläge, Autovervollständigung und einen Chat mit dem Modell direkt in den Code-Editor integriert. Im Grunde handelt es sich um dieselbe API, die jedoch über die IDE über die Erweiterung und nicht über die Befehlszeile aufgerufen wird. Beide Werkzeuge verwenden dasselbe Backend, daher zeigt sich das Problem der regionalen Blockierung in beiden Fällen gleich — die Erweiterung kann einfach keine Sitzung einrichten oder gibt einen Fehler bei der ersten Anfrage an das Modell zurück.
Ein wichtiger Punkt: Beide Werkzeuge führen Netzwerkabfragen nicht nur an die API für die Generierung selbst, sondern auch an die Google-Authentifizierungsdienste (OAuth, Identity Toolkit) durch. Wenn der Proxy nur für einen Endpunkt konfiguriert ist, kann die Authentifizierung erfolgreich sein, die Generierung jedoch nicht, oder umgekehrt. Daher muss der Proxy auf der Ebene der Systemumgebungsvariablen konfiguriert werden, nicht punktuell an einem Ort.
Warum ist Gemini in Ihrer Region nicht verfügbar
Google rollt neue AI-Produkte traditionell schrittweise aus: zuerst in den USA und einem Teil Europas, dann in den restlichen Ländern. Bei Gemini äußert sich dies in geografischen Einschränkungen auf API-Ebene — der Server überprüft die IP-Adresse der eingehenden Anfrage (und manchmal auch die Rechnungsadresse des Google-Kontos) und vergleicht sie mit der Liste der erlaubten Standorte. Wenn das Land nicht auf der Liste steht, wird die Anfrage mit einem Fehler bei der Vorbedingung abgebrochen oder einfach ohne klare Erklärung zeitüberschritten.
Dies ist keine Blockierung im herkömmlichen Sinne — der Anbieter Ihres Landes schneidet nichts ab, es handelt sich um einen Geo-Filter auf Seiten von Google. Entsprechend hilft ein VPN mit einer gemeinsamen IP oft nicht: Solche Adressen werden massenhaft von Tausenden von Menschen verwendet, Google markiert sie als verdächtig und verlangt entweder eine CAPTCHA-Abfrage oder schneidet sie dennoch nach Geo ab, wenn der IP-Bereich formal nicht im richtigen Land registriert ist. Eine Adresse, die wie eine normale Heim- oder Mobil-IP aus einer unterstützten Region aussieht, ist erforderlich — das heißt, die Aufgabe ist genau die gleiche, die von Wohn- und Mobilproxies gelöst wird.
Welchen Proxy sollten Sie für die Arbeit mit der Gemini API wählen
Für Entwicklungstools wie Gemini CLI sind die Schlüsselkriterien für Proxys die Stabilität der Sitzung (damit die Verbindung nicht mitten in der Generierung einer langen Antwort abbricht), die Geschwindigkeit und wie "sauber" die IP für die Antifraud-Systeme von Google aussieht. Hier ist ein Vergleich von drei Typen:
| Proxy-Typ | Geschwindigkeit | Risiko der Geo-Blockierung | Wann verwenden |
|---|---|---|---|
| Rechenzentrums-Proxys | Hoch | Mittel-Hoch | Schnelle Tests, einmalige API-Anfragen |
| Wohnproxies | Mittel-Hoch | Niedrig | Tägliche Arbeit mit Gemini CLI und Code Assist |
| Mobile Proxys | Mittel | Minimal | Wenn die Wohn-IP dennoch vom Geo-Filter blockiert wird |
In der Praxis sind für die tägliche Arbeit von Entwicklern am bequemsten Wohnproxies mit Bindung an ein bestimmtes Land und idealerweise mit einer Sticky-Sitzung von 10-30 Minuten — das reicht aus, um die OAuth-Authentifizierung nicht zu unterbrechen und die Terminal-Sitzung nicht mitten in der Code-Generierung zu verlieren. Rechenzentrums-Proxys sind günstiger und schneller, aber einige Bereiche sind Google bereits bekannt, und manchmal wird zusätzliche Kontoverifizierung bei der Anmeldung über eine solche IP angefordert. Mobile Proxys sollten als Reserve gehalten werden — wenn die Wohnadresse aus irgendeinem Grund auf die Liste der Verdächtigen gelangt, besteht normalerweise keine Frage, dass das Mobilfunknetz des Anbieters die Geo-Prüfung besteht.
Proxy im Terminal einrichten: Linux, macOS, Windows
Gemini CLI, wie die meisten Konsolenwerkzeuge auf Node.js (und es ist genau darauf geschrieben), respektiert die Standardumgebungsvariablen HTTP_PROXY und HTTPS_PROXY. Das reicht aus, um den gesamten CLI-Verkehr über den Proxy zu leiten, ohne die Anwendungs-Konfiguration zu ändern.
Für macOS und Linux (bash/zsh) fügen Sie in der aktuellen Sitzung hinzu:
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
Um den Proxy dauerhaft anzuwenden und nicht nur in der aktuellen Terminal-Sitzung, fügen Sie diese Zeilen in ~/.zshrc oder ~/.bashrc hinzu und starten Sie das Terminal mit dem Befehl source ~/.zshrc neu.
Für Windows werden die Variablen in PowerShell so festgelegt:
$env:HTTP_PROXY = "http://login:password@proxy_host:port"
$env:HTTPS_PROXY = "http://login:password@proxy_host:port"
gemini --version
Wenn Sie möchten, dass die Variablen nach dem Neustart von PowerShell erhalten bleiben, verwenden Sie [System.Environment]::SetEnvironmentVariable("HTTPS_PROXY", "http://login:password@proxy_host:port", "User") — die Variable wird im Benutzerprofil von Windows gespeichert.
Wenn Ihr Proxy eine separate Authentifizierung ohne Login in der URL erfordert (z. B. über eine IP-Whitelist), entfernen Sie einfach den Login und das Passwort aus der Verbindungszeichenfolge und fügen Sie die IP Ihres Servers oder Arbeitsgeräts in die Whitelist auf der Seite des Proxy-Anbieters hinzu.
Proxy in VS Code für Code Assist einrichten
VS Code hat eigene Proxy-Einstellungen, die nicht automatisch aus den Umgebungsvariablen des Systems übernommen werden, es sei denn, die entsprechende Option ist aktiviert. Öffnen Sie settings.json (Ctrl+Shift+P → "Preferences: Open User Settings (JSON)") und fügen Sie hinzu:
{
"http.proxy": "http://login:password@proxy_host:port",
"http.proxyStrictSSL": false,
"http.proxySupport": "override"
}
Der Parameter http.proxySupport: "override" ist wichtig: Ohne ihn kann VS Code weiterhin den Systemproxy verwenden oder die Einstellung für einzelne Erweiterungen ganz ignorieren. Nach der Änderung der Einstellungen starten Sie VS Code vollständig neu (nicht nur das Fenster), da die Erweiterung Gemini Code Assist den Netzwerkclient einmal beim Start der Anwendung initialisiert.
Wenn die Erweiterung den Proxy trotzdem nicht erkennt, überprüfen Sie die Einstellung http.proxyAuthorization — in seltenen Fällen blockieren Unternehmensversionen von VS Code die Übertragung von Login und Passwort in der Proxy-URL aus Sicherheitsgründen, und dann müssen die Anmeldedaten über den Header Proxy-Authorization in base64 übergeben werden.
Ein weiterer Punkt — deaktivieren Sie vorübergehend Diagnosetools wie Unternehmens-VPN-Clients und Antivirusprogramme mit Traffic-Interception (SSL-Inspektion). Diese ersetzen oft das Zertifikat in Echtzeit, und Gemini Code Assist, das die Zertifikatskette von Google streng überprüft, wird die Verbindung mit einem TLS-Fehler abbrechen, der leicht mit einem Problem des Proxys verwechselt werden kann.
Proxy direkt in Gemini CLI einrichten
Neben den Umgebungsvariablen kann der Proxy in Gemini CLI auch über eine Projektkonfigurationsdatei oder globale Benutzereinstellungen festgelegt werden — dies ist praktisch, wenn Sie verschiedene Proxys für verschiedene Projekte verwenden möchten, ohne die Systemvariablen zu ändern. Die Konfiguration wird normalerweise in ~/.gemini/settings.json oder in einer .env-Datei im Projektverzeichnis gespeichert:
# .env im Stammverzeichnis des Projekts
GEMINI_API_KEY=Ihr_Schlüssel
HTTPS_PROXY=http://login:password@proxy_host:port
HTTP_PROXY=http://login:password@proxy_host:port
Wenn Sie sich über ein Google Cloud-Konto (Vertex AI) und nicht über den AI Studio-Schlüssel authentifizieren, muss zusätzlich sichergestellt werden, dass der Proxy auch von dem Tool gcloud verwendet wird, über das der OAuth-Flow läuft. Für dieses Tool wird der Proxy separat festgelegt:
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
Wenn nach diesem Schritt gcloud auth login dennoch den Browser mit der realen (nicht proxierten) IP zur Bestätigung des Zugriffs öffnet, beachten Sie: Die OAuth-Seite wird direkt in Ihrem Systembrowser geöffnet, und wenn der Browser nicht auf denselben Proxy eingestellt ist, kann die endgültige Authentifizierungssitzung ein Token erhalten, das an Ihre tatsächliche IP gebunden ist. Um vollständige Konsistenz zu gewährleisten, sollten Sie den Proxy auch im Browser einrichten, mit dem Sie den Zugriff bestätigen — zum Beispiel über eine Proxy-Erweiterung oder die Systemeinstellungen des Netzwerks während der Authentifizierung.
Verbindungstest: curl und Python
Bevor Sie herausfinden, warum genau Gemini CLI nicht funktioniert, stellen Sie sicher, dass der Proxy grundsätzlich den Verkehr zur Google API weiterleitet. Der schnellste Weg ist eine direkte Anfrage über curl:
curl -x http://login:password@proxy_host:port \
"https://generativelanguage.googleapis.com/v1beta/models?key=IHRE_API_KEY"
Wenn als Antwort ein JSON mit einer Liste von Modellen (gemini-1.5-flash, gemini-1.5-pro usw.) zurückkommt — der Proxy funktioniert und die Region wird unterstützt. Wenn Sie 403 oder FAILED_PRECONDITION sehen — das Problem liegt auf der Ebene des Geo-Filters, Sie müssen das Land des Proxys ändern.
Für eine detailliertere Diagnose ist es praktisch, Python mit expliziter Angabe des Proxys für die Sitzung zu verwenden:
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": "IHRE_API_KEY"}
response = requests.get(url, params=params, proxies=proxies, timeout=15)
print(response.status_code)
print(response.text[:500])
Ein solches Skript ist praktisch, um es als schnelle Überprüfung vor dem Start einer vollständigen Sitzung in CLI oder IDE bereitzuhalten — es zeigt in wenigen Sekunden, ob das Netzwerk, der Schlüssel oder die IP-Region das Problem sind.
Häufige Fehler und deren Lösungen
Fehler "User location is not supported" selbst nach dem Verbinden mit dem Proxy bedeutet normalerweise, dass die IP des Proxy-Servers entweder in einem nicht unterstützten Land liegt oder Google sie als Rechenzentrums-IP identifiziert hat und eine zusätzliche Überprüfung angewendet hat. Die Lösung besteht darin, auf eine Wohn- oder Mobil-IP aus den USA oder einem anderen Land mit vollständiger Unterstützung von Gemini zu wechseln.
Timeouts bei der Generierung langer Antworten hängen meist mit einer instabilen Proxy-Sitzung zusammen — die IP ändert sich mitten in der Anfrage, und die Verbindung bricht ab. Eine Sticky-Sitzung ist erforderlich, die länger als die typische Anfrage dauert (normalerweise reicht ein Puffer von 10-15 Minuten sogar für umfangreiche Code-Generierungen aus).
Fehler SSL/TLS handshake failed deutet fast immer auf eine Traffic-Interception durch Antivirus-Software, eine Unternehmensfirewall oder eine falsch konfigurierte proxyStrictSSL in VS Code hin. Überprüfen Sie, ob auf dem Rechner Software mit SSL-Inspektion installiert ist, und deaktivieren Sie sie vorübergehend zur Diagnose.
CLI funktioniert, aber die Erweiterung in VS Code nicht (oder umgekehrt) bedeutet, dass die Umgebungsvariablen nicht in den VS Code-Prozess übergeben wurden. Dies ist eine häufige Situation in Linux und macOS, wenn VS Code nicht aus dem Terminal gestartet wurde, in dem die Variablen exportiert wurden, sondern aus dem Symbol im Systemmenü. In diesem Fall müssen die Variablen genau über settings.json festgelegt werden, wie oben beschrieben, und nicht auf die Vererbung aus der Shell gehofft werden.
IP-Bindung an die Region des API-Schlüssels und Sicherheit
Eine separate Feinheit, die oft vergessen wird: Wenn der API-Schlüssel oder das Google Cloud-Projekt mit einer bestimmten Abrechnungsregion verknüpft wurde, kann der Wechsel der Proxy-IP zu einer Diskrepanz zwischen dem erwarteten und dem tatsächlichen Standort führen, und Google verlangt manchmal eine erneute Verifizierung per SMS oder E-Mail. Um die Häufigkeit solcher Überprüfungen zu verringern, versuchen Sie, Proxys mit einer festen (nicht rotierenden) IP aus demselben Land zu verwenden — dies erscheint für die Schutzsysteme von Google als normales Verhalten eines Benutzers, der einfach in diesem Land lebt, und nicht als verdächtige Aktivität.
Wenn Sie gleichzeitig mit mehreren Projekten oder Schlüsseln arbeiten und einen Anti-Detection-Browser wie Dolphin Anty oder AdsPower zur Isolierung von Profilen verwenden (was relevant ist, wenn Sie Gemini-Integrationen in verschiedenen Browser-Umgebungen testen), binden Sie an jedes Profil einen separaten Proxy mit fester Geolokalisierung — so verringert sich das Risiko, dass ein Projekt Verdacht erregt, weil es gemischte IPs eines anderen Projekts verwendet.
Verwenden Sie auch nicht denselben kostenlosen oder gemeinsamen Proxy für Gemini und gleichzeitig für andere hochbelastete Aufgaben — eine große Anzahl paralleler Sitzungen von einer IP erhöht die Wahrscheinlichkeit, unter Rate-Limits oder vorübergehenden Blockierungen auf Google-Ebene zu fallen, was ebenso aussieht wie ein Problem mit der Region, obwohl der Grund völlig anders ist.
Fazit
Die Einschränkung von Gemini CLI und Gemini Code Assist nach Region wird auf Netzwerkebene gelöst: Der Proxy muss gleichzeitig in den Umgebungsvariablen des Systems, in den Einstellungen von VS Code und, wenn Google Cloud verwendet wird, in der gcloud-Konfiguration festgelegt werden — nur dann funktionieren alle drei Einstiegspunkte (CLI, IDE-Erweiterung und OAuth-Authentifizierung) über dieselbe IP ohne Synchronisationsprobleme. Überprüfen Sie vor der vollständigen Nutzung immer die Verbindung mit einer einfachen curl-Anfrage — das spart Stunden bei der Diagnose, wenn das Problem tatsächlich nicht im Code, sondern im Land des Proxys liegt.
Für eine stabile tägliche Arbeit mit Gemini CLI sind am besten Wohnproxies mit fester Geolokalisierung und einer langen Sticky-Sitzung geeignet — sie sehen aus wie eine normale Heim-IP und lösen selten zusätzliche Überprüfungen von Google aus. Wenn die Wohnadresse dennoch unter den Geo-Filter fällt, sollten Sie mobile Proxys ausprobieren, und für schnelle einmalige API-Tests ohne lange Sitzung reichen Rechenzentrums-Proxys völlig aus.