← Bloga geri dön

Gemini CLI ve VS Code Code Assist için Proxy: Google Desteği Olmayan Bölgeden Erişim

HTTP/HTTPS proxy ayarları için adım adım kılavuz, eğer bölgeniz Google tarafından desteklenmiyorsa, Gemini CLI ve VS Code'daki Gemini Code Assist uzantısı için.

📅14 Kasım 2026

Eğer Gemini CLI'ye giriş yapmaya çalışırken veya VS Code'daki Gemini Code Assist uzantısını kullanırken FAILED_PRECONDITION: Kullanıcı konumu desteklenmiyor gibi bir hata alıyorsanız, sorun hesabınızda veya kodda değil. Google AI Studio ve Gemini API, ülkeler arasında eşit dağıtılmamaktadır ve bazı bölgeler desteklenenler listesinden tamamen çıkarılmıştır. Bu, izin verilen bir ülkeden IP adresi ile proxy ayarlayarak çözülebilir — şimdi bunu terminalde, VS Code'da ve ortam değişkenleri düzeyinde nasıl doğru bir şekilde yapacağımızı inceleyeceğiz.

Gemini CLI ve Gemini Code Assist nedir

Gemini CLI, Google'ın terminalden Gemini modelleri ile iletişim kurmanıza olanak tanıyan bir konsol aracıdır: kod yazmak, komutlar oluşturmak, proje dosyalarını analiz etmek ve çalışma ortamından çıkmadan görevleri yerine getirmek için kullanılır. API'ye generativelanguage.googleapis.com alan adları üzerinden veya Vertex AI aracılığıyla erişir; hangi yetkilendirme yöntemini kullandığınıza bağlı olarak — Google AI Studio anahtarı veya Google Cloud hesabı.

Gemini Code Assist, VS Code (ve JetBrains IDE) için bir uzantıdır; kod editörüne doğrudan model ile sohbet, ipuçları ve otomatik tamamlama özelliklerini entegre eder. Temelde aynı API'dir, ancak IDE'den uzantı aracılığıyla çağrılır, komut satırından değil. Her iki araç da aynı arka ucu kullanır, bu nedenle bölgesel engelleme sorunu her iki durumda da aynı şekilde ortaya çıkar — uzantı oturumu başlatamaz veya modelin ilk isteğinde hata döner.

Önemli bir nokta: her iki araç da yalnızca API'ye değil, aynı zamanda Google'ın yetkilendirme hizmetlerine (OAuth, Identity Toolkit) de ağ istekleri gönderir. Proxy yalnızca bir uç noktası için ayarlanmışsa, yetkilendirme geçebilir, ancak üretim geçmeyebilir veya tam tersi. Bu nedenle, proxy'yi sistem ortam değişkenleri düzeyinde ayarlamak gerekir, tek bir yerde değil.

Neden Gemini sizin bölgenizde mevcut değil

Google, yeni AI ürünlerini genellikle aşamalı olarak dağıtır: önce ABD ve Avrupa'nın bir kısmı, ardından diğer ülkeler. Gemini için bu, API düzeyinde coğrafi kısıtlamalar şeklinde kendini gösterir — sunucu, gelen isteğin IP adresini (ve bazen Google hesabının faturalama adresini) kontrol eder ve izin verilen konumlar listesi ile karşılaştırır. Eğer ülke listede yoksa, istek precondition hatası ile kesilir veya açık bir açıklama olmadan zaman aşımına uğrar.

Bu, alışıldık anlamda bir engelleme değildir — sizin ülkenizdeki sağlayıcı hiçbir şeyi kesmez, burada Google tarafında bir coğrafi filtre söz konusudur. Dolayısıyla, genel bir IP ile VPN genellikle işe yaramaz: bu tür adresler binlerce insan tarafından yaygın olarak kullanılır, Google bunları şüpheli olarak işaretler ve ya CAPTCHA ister ya da yine de coğrafi olarak keser, eğer IP aralığı resmi olarak o ülkede kayıtlı değilse. İzin verilen bir bölgeden gelen normal bir ev veya mobil IP gibi görünen bir adrese ihtiyacınız var — yani, bu, konut ve mobil proxylerin çözdüğü aynı sorundur.

Gemini API ile çalışmak için hangi proxyyi seçmelisiniz

Gemini CLI gibi geliştirme araçları için proxy'nin anahtar parametreleri — oturumun kararlılığı (uzun bir yanıtın üretimi sırasında bağlantının kesilmemesi için), hız ve IP'nin Google'ın anti-fraud sistemleri için ne kadar "temiz" göründüğüdür. İşte üç türün karşılaştırması:

Proxy Türü Hız Coğrafi engelleme riski Ne zaman kullanılmalı
Veri merkezi proxyleri Yüksek Orta-yüksek Hızlı testler, API'ye tek seferlik istekler
Konut proxyleri Orta-yüksek Düşük Gemini CLI ve Code Assist ile günlük çalışma
Mobil proxyler Orta Minimum Konut IP'si coğrafi filtre ile kesiliyorsa

Pratikte, günlük geliştirici çalışmaları için en uygun olanı konut proxyleridir; belirli bir ülkeye bağlı ve tercihen 10-30 dakikalık yapışkan oturum ile — bu, OAuth yetkilendirmesinin kesilmemesi ve terminal oturumunun uzun kod üretimi sırasında düşmemesi için yeterlidir. Veri merkezi proxyleri daha ucuz ve hızlıdır, ancak Google, bazı IP aralıklarını zaten biliyor ve bazen böyle bir IP üzerinden giriş yaparken ek hesap doğrulaması isteyebiliyor. Mobil proxyleri yedekte tutmakta fayda var — eğer konut adresi bir şekilde şüpheli listesine düştüyse, operatörün mobil ağı genellikle coğrafi kontrolü sorunsuz geçer.

Terminalde proxy ayarlama: Linux, macOS, Windows

Gemini CLI, çoğu Node.js konsol aracı gibi (ve bu tam olarak onun üzerinde yazılmıştır), standart ortam değişkenlerini HTTP_PROXY ve HTTPS_PROXY dikkate alır. Bu, uygulama yapılandırmalarını değiştirmeden tüm CLI trafiğini proxy üzerinden yönlendirmek için yeterlidir.

macOS ve Linux (bash/zsh) için mevcut oturuma ekleyin:

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

Proxy'nin sürekli uygulanmasını istiyorsanız, bu satırları ~/.zshrc veya ~/.bashrc dosyasına ekleyin ve terminali source ~/.zshrc komutuyla yeniden başlatın.

Windows'ta PowerShell'de değişkenler şu şekilde ayarlanır:

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

gemini --version

PowerShell'i yeniden başlattıktan sonra değişkenlerin kalıcı olmasını istiyorsanız, [System.Environment]::SetEnvironmentVariable("HTTPS_PROXY", "http://login:password@proxy_host:port", "User") kullanın — değişken Windows kullanıcı profilinize kaydedilecektir.

Eğer proxy'niz URL'de giriş olmadan ayrı bir yetkilendirme gerektiriyorsa (örneğin, IP beyaz listesi ile), bağlantı dizesinden giriş ve şifreyi kaldırın ve proxy sağlayıcısının panelinde sunucunuzun veya çalışma makinenizin IP'sini beyaz listeye ekleyin.

Code Assist için VS Code'da proxy ayarlama

VS Code, sistem ortam değişkenlerinden otomatik olarak miras alınmayan kendi proxy ayarlarına sahiptir, eğer ilgili seçenek etkin değilse. settings.json dosyasını açın (Ctrl+Shift+P → "Preferences: Open User Settings (JSON)") ve ekleyin:

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

http.proxySupport: "override" parametresi önemlidir: bu olmadan VS Code, sistem proxy'sini kullanmaya devam edebilir veya belirli uzantılar için ayarı tamamen göz ardı edebilir. Ayarları düzenledikten sonra VS Code'u tamamen yeniden başlatın (sadece pencereyi yeniden yüklemek yeterli değildir), çünkü Gemini Code Assist uzantısı, uygulama başlatıldığında ağ istemcisini bir kez başlatır.

Eğer uzantı yine de proxy'yi göremiyorsa, http.proxyAuthorization ayarını kontrol edin — nadir durumlarda, kurumsal yapılandırmalar, güvenlik nedenleriyle proxy URL'sinde giriş ve şifre iletimi engelleyebilir, bu durumda kimlik bilgilerini base64 formatında Proxy-Authorization başlığı aracılığıyla iletmek gerekir.

Ayrıca, kurumsal VPN istemcileri ve trafiği yakalayan antivirüsler gibi uzantıların tanılamasını geçici olarak devre dışı bırakın. Genellikle sertifikayı anlık olarak değiştirdikleri için, Google'ın sertifika zincirini sıkı bir şekilde kontrol eden Gemini Code Assist, TLS hatası ile bağlantıyı kesebilir; bu, proxy ile ilgili bir sorunla karıştırılabilir.

Gemini CLI'de proxy ayarlama

Ortam değişkenlerinin yanı sıra, Gemini CLI'de proxy'yi proje yapılandırma dosyası veya kullanıcı global ayarları aracılığıyla ayarlamak mümkündür — bu, farklı projeler için farklı proxy'ler kullanmak istediğinizde sistem ortam değişkenlerini değiştirmeden kullanışlıdır. Konfigürasyon genellikle ~/.gemini/settings.json veya proje dizininde bulunan .env dosyasında saklanır:

# Proje kökünde .env
GEMINI_API_KEY=sizin_anahtarınız
HTTPS_PROXY=http://login:password@proxy_host:port
HTTP_PROXY=http://login:password@proxy_host:port

Eğer Google Cloud hesabı (Vertex AI) üzerinden yetkilendirme yapıyorsanız ve AI Studio anahtarı kullanmıyorsanız, proxy'nin gcloud aracı tarafından da kullanılması gerekir; bu araç OAuth akışını yönetir. Bunun için proxy ayrı olarak ayarlanır:

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

Eğer bu ayarlardan sonra gcloud auth login hala gerçek (proxy üzerinden geçmeyen) IP ile tarayıcıyı açıyorsa, dikkate alın: OAuth sayfası doğrudan sistem tarayıcınızda açılır ve eğer tarayıcı aynı proxy ile ayarlanmamışsa, nihai yetkilendirme oturumu gerçek IP'nizle ilişkilendirilmiş bir token alabilir. Tam uyumluluk için, giriş onayladığınız tarayıcıda proxy'yi ayarlamak — örneğin, bir proxy uzantısı veya ağ ayarları aracılığıyla — yararlı olacaktır.

Bağlantı testi: curl ve Python

Gemini CLI'nin neden çalışmadığını anlamadan önce, proxy'nin genel olarak Google API'ye trafik yönlendirdiğinden emin olun. En hızlı yol, curl ile doğrudan bir istek yapmaktır:

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

Eğer yanıt olarak modellerin bir listesini içeren bir JSON alıyorsanız (gemini-1.5-flash, gemini-1.5-pro vb.) — proxy çalışıyor ve bölge destekleniyor demektir. Eğer 403 veya FAILED_PRECONDITION görüyorsanız — sorun coğrafi filtre düzeyindedir, proxy'nin ülkesini değiştirmeniz gerekir.

Daha ayrıntılı bir tanı için, oturum için proxy'yi açıkça belirterek Python kullanmak uygundur:

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": "SİZİN_API_ANAHTARINIZ"}

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

Bu tür bir script, CLI veya IDE'de tam bir oturum başlatmadan önce hızlı bir kontrol için el altında bulundurulabilir — birkaç saniye içinde, ağın, anahtarın veya IP'nin bölgesinin suçlu olup olmadığını gösterir.

Sık karşılaşılan hatalar ve çözümleri

"Kullanıcı konumu desteklenmiyor" hatası proxy'ye bağlandıktan sonra bile genellikle, proxy sunucusunun IP'sinin ya desteklenmeyen bir ülkede olduğunu ya da Google tarafından veri merkezi olarak belirlendiğini ve ek bir kontrol uygulandığını gösterir. Çözüm — ABD veya Gemini'nin tam desteklendiği başka bir ülkeden konut veya mobil IP'ye geçmektir.

Uzun yanıtların üretilmesi sırasında zaman aşımı çoğu zaman proxy'nin kararsız oturumları ile ilgilidir — IP, isteğin ortasında değişir ve bağlantı kesilir. Yapışkan bir oturum, tipik isteği aşan bir süre (genellikle 10-15 dakika, büyük kod üretimleri için yeterlidir) gereklidir.

SSL/TLS el sıkışması başarısız oldu hatası neredeyse her zaman bir antivirüs, kurumsal güvenlik duvarı veya VS Code'daki yanlış yapılandırılmış proxyStrictSSL ile ilgilidir. Makinede SSL denetimi yapan bir yazılım olup olmadığını kontrol edin ve tanıma için geçici olarak devre dışı bırakın.

CLI çalışıyor, ancak VS Code'daki uzantı çalışmıyor (veya tam tersi) durumu, ortam değişkenlerinin VS Code sürecine aktarılmadığını gösterir. Bu, VS Code'un, değişkenlerin dışarı aktarıldığı terminalden değil, sistem menüsündeki simgeden başlatıldığı durumlarda Linux ve macOS'ta sık görülen bir durumdur. Bu durumda, değişkenleri yukarıda açıklandığı gibi settings.json üzerinden ayarlamak gerekir; shell'den miras alınmasını beklemek yerine.

API anahtarının bölgeye bağlanması ve güvenlik

Sıklıkla unutulan ayrı bir incelik: eğer API anahtarı veya Google Cloud projesi belirli bir faturalama bölgesine bağlı olarak oluşturulmuşsa, proxy IP'sinin değiştirilmesi beklenen ve gerçek konumun uyuşmamasına neden olabilir ve Google bazen SMS veya e-posta ile yeniden doğrulama isteyebilir. Bu tür kontrollerin sıklığını azaltmak için, aynı ülkeden sabit (her istekte dönen değil) bir IP ile proxy kullanmaya çalışın — bu, Google'ın koruma sistemleri için, bu ülkede yaşayan bir kullanıcının normal davranışı gibi görünür, şüpheli bir aktivite olarak değil.

Eğer birden fazla proje veya anahtar ile aynı anda çalışıyorsanız ve farklı tarayıcı ortamlarında Gemini entegrasyonlarını test ediyorsanız, her profile ayrı bir sabit coğrafi konum ile proxy bağlayın — böylece bir projenin başka bir projenin karışık IP'leri nedeniyle şüphe çekme riski azalır.

Ayrıca, Gemini için aynı ücretsiz veya genel proxy'yi diğer yüksek yük gerektiren görevler için kullanmaktan kaçının — aynı IP üzerinden çok sayıda eşzamanlı oturum, Google düzeyinde rate-limit veya geçici bir engelleme riski artırır; bu, bölge ile ilgili bir sorun gibi görünse de, neden tamamen farklıdır.

Sonuç

Gemini CLI ve Gemini Code Assist'in bölgesel kısıtlaması, ağ düzeyinde çözülür: proxy, sistem ortam değişkenlerinde, VS Code ayarlarında ve Google Cloud kullanıyorsanız gcloud yapılandırmasında aynı anda ayarlanmalıdır — ancak o zaman tüm üç giriş noktası (CLI, IDE uzantısı ve OAuth yetkilendirmesi) aynı IP üzerinden çalışır ve senkronizasyon sorunu olmaz. Tam bir çalışma öncesinde, basit bir curl isteği ile bağlantıyı her zaman kontrol edin — bu, sorun aslında kodda değil, proxy ülkesinde olduğunda saatlerce tanıma süresinden tasarruf sağlar.

Gemini CLI ile istikrarlı günlük çalışma için en uygun olanı konut proxyleridir; sabit coğrafi konum ve uzun yapışkan oturum ile — bunlar, normal bir ev IP'si gibi görünür ve nadiren Google tarafından ek kontroller gerektirir. Eğer konut adresi yine de coğrafi filtreye takılırsa, mobil proxyleri denemek faydalı olabilir; hızlı tek seferlik API testleri için ise veri merkezi proxyleri yeterlidir.