← Kembali ke blog

Proxy untuk Gemini CLI dan VS Code Code Assist: akses dari wilayah tanpa dukungan Google

Panduan langkah demi langkah untuk mengatur proxy HTTP/HTTPS untuk Gemini CLI dan ekstensi Gemini Code Assist di VS Code, jika wilayah Anda tidak didukung oleh Google.

📅14 November 2026

Jika saat mencoba untuk masuk ke Gemini CLI atau menggunakan ekstensi Gemini Code Assist di VS Code Anda melihat kesalahan seperti FAILED_PRECONDITION: Lokasi pengguna tidak didukung — masalahnya bukan pada akun Anda dan bukan pada kode. Google AI Studio dan Gemini API diluncurkan secara tidak merata di berbagai negara, dan beberapa wilayah hanya dikecualikan dari daftar yang didukung. Ini dapat diatasi dengan mengatur proxy dengan alamat IP dari negara yang diizinkan — dan selanjutnya kita akan membahas cara melakukannya dengan benar di terminal, di VS Code, dan pada tingkat variabel lingkungan.

Apa itu Gemini CLI dan Gemini Code Assist

Gemini CLI adalah alat konsol Google yang memungkinkan Anda berinteraksi dengan model Gemini langsung dari terminal: menulis kode, menghasilkan perintah, menganalisis file proyek, dan menjalankan tugas agen tanpa keluar dari lingkungan kerja. Ini mengakses API di domain generativelanguage.googleapis.com atau melalui Vertex AI, tergantung pada metode otorisasi yang Anda gunakan — kunci Google AI Studio atau akun Google Cloud.

Gemini Code Assist adalah ekstensi untuk VS Code (dan juga untuk JetBrains IDE) yang menyematkan saran, pelengkapan otomatis, dan obrolan dengan model langsung di editor kode. Pada dasarnya ini adalah API yang sama, tetapi dipanggil dari IDE melalui ekstensi, bukan dari baris perintah. Kedua alat ini menggunakan backend yang sama, sehingga masalah pemblokiran wilayah muncul dengan cara yang sama di kedua kasus — ekstensi hanya tidak dapat membuat sesi atau mengembalikan kesalahan pada permintaan pertama ke model.

Nuansa penting: kedua alat ini melakukan permintaan jaringan tidak hanya ke API generasi itu sendiri, tetapi juga ke layanan otorisasi Google (OAuth, Identity Toolkit). Jika proxy hanya diatur untuk satu endpoint, otorisasi mungkin berhasil, tetapi generasi tidak, atau sebaliknya. Oleh karena itu, proxy perlu diatur pada tingkat variabel lingkungan sistem, bukan hanya di satu tempat.

Mengapa Gemini tidak tersedia di wilayah Anda

Google secara tradisional meluncurkan produk AI baru secara bertahap: pertama di AS dan sebagian Eropa, kemudian negara-negara lainnya. Untuk Gemini, ini terwujud dalam batasan geografis pada tingkat API — server memeriksa alamat IP dari permintaan masuk (dan kadang-kadang juga alamat penagihan akun Google) dan membandingkannya dengan daftar lokasi yang diizinkan. Jika negara tidak ada dalam daftar, permintaan akan terputus dengan kesalahan precondition atau hanya timeout tanpa penjelasan yang jelas.

Ini bukan pemblokiran dalam arti kata biasa — penyedia di negara Anda tidak memotong apa pun, ini adalah tentang geo-filter di sisi Google. Oleh karena itu, VPN dengan IP umum sering kali tidak membantu: alamat semacam itu digunakan secara massal oleh ribuan orang, Google menandainya sebagai mencurigakan dan baik meminta CAPTCHA atau tetap memotong berdasarkan geo, jika rentang IP secara formal terdaftar tidak di negara itu. Anda memerlukan alamat yang terlihat seperti IP rumah atau seluler biasa dari wilayah yang didukung — jadi tugasnya sama persis dengan yang diselesaikan oleh proxy residensial dan seluler.

Proxy mana yang harus dipilih untuk bekerja dengan Gemini API

Untuk alat pengembangan seperti Gemini CLI, parameter kunci proxy adalah stabilitas sesi (agar tidak terputus di tengah generasi respons yang panjang), kecepatan, dan seberapa "bersih" IP terlihat untuk sistem anti-fraud Google. Berikut adalah perbandingan tiga jenis:

Jenis Proxy Kecepatan Risiko Pemblokiran Geo Kapan Digunakan
Proxy Data Center Tinggi Sedang-tinggi Pengujian cepat, permintaan sekali saja ke API
Proxy Residensial Sedang-tinggi Rendah Pekerjaan harian dengan Gemini CLI dan Code Assist
Proxy Seluler Sedang Minimal Ketika IP residensial tetap terputus oleh geo-filter

Dalam praktiknya, untuk pekerjaan sehari-hari pengembang, yang paling nyaman adalah proxy residensial yang terikat pada negara tertentu dan sebaiknya dengan sesi sticky selama 10-30 menit — ini cukup untuk tidak memutuskan otorisasi OAuth dan tidak menghilangkan sesi terminal di tengah generasi kode. Proxy data center lebih murah dan lebih cepat, tetapi beberapa rentang IP sudah dikenal oleh Google dan kadang-kadang meminta verifikasi tambahan untuk akun saat masuk melalui IP semacam itu. Proxy seluler sebaiknya disimpan sebagai cadangan — jika alamat residensial tiba-tiba masuk dalam daftar mencurigakan, jaringan seluler operator biasanya lolos pemeriksaan geo tanpa masalah.

Mengatur proxy di terminal: Linux, macOS, Windows

Gemini CLI, seperti sebagian besar utilitas konsol di Node.js (dan ini ditulis di atasnya), menghormati variabel lingkungan standar HTTP_PROXY dan HTTPS_PROXY. Ini cukup untuk mengalihkan seluruh lalu lintas CLI melalui proxy tanpa mengedit konfigurasi aplikasi.

Untuk macOS dan Linux (bash/zsh) tambahkan ke sesi saat ini:

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

Agar proxy diterapkan secara permanen, bukan hanya di sesi terminal saat ini, tambahkan baris yang sama ini ke ~/.zshrc atau ~/.bashrc dan restart terminal dengan perintah source ~/.zshrc.

Untuk Windows di PowerShell, variabel ditetapkan seperti ini:

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

gemini --version

Jika Anda ingin agar variabel tetap ada setelah restart PowerShell, gunakan [System.Environment]::SetEnvironmentVariable("HTTPS_PROXY", "http://login:password@proxy_host:port", "User") — variabel akan dicatat di profil pengguna Windows.

Jika proxy Anda memerlukan otorisasi terpisah tanpa login di URL (misalnya, melalui whitelist IP), cukup hapus login dan kata sandi dari string koneksi dan tambahkan IP server atau mesin kerja Anda ke whitelist di panel penyedia proxy.

Mengatur proxy di VS Code untuk Code Assist

VS Code memiliki pengaturan proxy sendiri yang tidak diwarisi secara otomatis dari variabel lingkungan sistem, kecuali opsi yang sesuai diaktifkan. Buka settings.json (Ctrl+Shift+P → "Preferences: Open User Settings (JSON)") dan tambahkan:

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

Parameter http.proxySupport: "override" penting: tanpa itu, VS Code dapat terus menggunakan proxy sistem atau bahkan mengabaikan pengaturan untuk ekstensi tertentu. Setelah mengedit pengaturan, restart VS Code sepenuhnya (bukan hanya me-reload jendela), karena ekstensi Gemini Code Assist menginisialisasi klien jaringan hanya sekali saat aplikasi dimulai.

Jika ekstensi tetap tidak melihat proxy, periksa pengaturan http.proxyAuthorization — dalam kasus yang jarang terjadi, build perusahaan VS Code memblokir pengiriman login dan kata sandi dalam URL proxy karena alasan keamanan, dan kredensial perlu dikirim melalui header Proxy-Authorization dalam base64.

Satu hal terpisah — matikan sementara diagnosis ekstensi seperti klien VPN perusahaan dan antivirus dengan penyadapan lalu lintas (inspeksi SSL). Mereka sering kali mengganti sertifikat secara langsung, dan Gemini Code Assist, yang memeriksa rantai sertifikat Google secara ketat, akan memutuskan koneksi dengan kesalahan TLS, yang mudah disalahartikan sebagai masalah dengan proxy itu sendiri.

Mengatur proxy di Gemini CLI itu sendiri

Selain variabel lingkungan, di Gemini CLI Anda dapat menetapkan proxy melalui file konfigurasi proyek atau pengaturan global pengguna — ini nyaman jika Anda ingin menggunakan proxy yang berbeda untuk proyek yang berbeda tanpa mengubah variabel sistem. Konfigurasi biasanya disimpan di ~/.gemini/settings.json atau di file .env di dalam direktori proyek:

# .env di root proyek
GEMINI_API_KEY=your_key
HTTPS_PROXY=http://login:password@proxy_host:port
HTTP_PROXY=http://login:password@proxy_host:port

Jika Anda masuk melalui akun Google Cloud (Vertex AI), bukan melalui kunci AI Studio, Anda juga perlu memastikan bahwa proxy digunakan oleh utilitas gcloud, yang digunakan untuk proses OAuth. Untuk itu, proxy ditetapkan secara terpisah:

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

Jika setelah itu gcloud auth login tetap membuka browser dengan IP nyata (tidak diproksikan) untuk konfirmasi masuk, ingatlah: halaman OAuth itu sendiri dibuka di browser sistem Anda secara langsung, dan jika browser tidak diatur pada proxy yang sama, sesi otorisasi akhir dapat menerima token yang terikat pada IP nyata Anda. Untuk konsistensi penuh, sebaiknya atur proxy di browser yang Anda gunakan untuk mengonfirmasi masuk — misalnya, melalui ekstensi proxy atau pengaturan jaringan sistem untuk sementara selama otorisasi.

Memeriksa koneksi: curl dan Python

Sebelum mencari tahu mengapa Gemini CLI tidak berfungsi, pastikan bahwa proxy secara umum meneruskan lalu lintas ke API Google. Cara tercepat adalah dengan permintaan langsung melalui curl:

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

Jika responsnya adalah JSON dengan daftar model (gemini-1.5-flash, gemini-1.5-pro, dan seterusnya) — proxy berfungsi dan wilayah didukung. Jika Anda melihat 403 atau FAILED_PRECONDITION — masalahnya ada di tingkat geo-filter, Anda perlu mengganti negara proxy.

Untuk diagnosis yang lebih mendetail, Anda dapat menggunakan Python dengan penetapan proxy yang jelas untuk sesi:

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

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

Skrip semacam ini nyaman untuk disimpan sebagai pemeriksaan cepat sebelum memulai sesi penuh di CLI atau di IDE — ini menunjukkan dalam beberapa detik apakah jaringan, kunci, atau wilayah IP yang menjadi masalah.

Kesalahan umum dan solusinya

Kesalahan "Lokasi pengguna tidak didukung" bahkan setelah menghubungkan proxy biasanya berarti bahwa IP server proxy berada di negara yang tidak didukung, atau Google telah mengidentifikasinya sebagai data center dan menerapkan pemeriksaan tambahan. Solusinya adalah beralih ke IP residensial atau seluler dari AS atau negara lain yang sepenuhnya mendukung Gemini.

Timeout saat menghasilkan respons panjang paling sering terkait dengan sesi proxy yang tidak stabil — IP berubah di tengah permintaan, dan koneksi terputus. Diperlukan sesi sticky untuk waktu yang melebihi permintaan tipikal (biasanya 10-15 menit dengan cadangan cukup untuk bahkan generasi kode yang besar).

Kesalahan SSL/TLS handshake failed hampir selalu menunjukkan penyadapan lalu lintas oleh antivirus, firewall perusahaan, atau proxyStrictSSL yang tidak diatur dengan benar di VS Code. Periksa apakah ada perangkat lunak dengan inspeksi SSL di mesin, dan matikan sementara untuk diagnosis.

CLI berfungsi, tetapi ekstensi di VS Code tidak (atau sebaliknya) berarti bahwa variabel lingkungan tidak diteruskan ke proses VS Code. Ini adalah situasi umum di Linux dan macOS, jika VS Code dijalankan tidak dari terminal tempat variabel diekspor, tetapi dari ikon di menu sistem. Dalam hal ini, variabel harus ditetapkan melalui settings.json, seperti yang dijelaskan di atas, dan bukan mengandalkan pewarisan dari shell.

Ikatan IP ke wilayah kunci API dan keamanan

Satu nuansa terpisah yang sering dilupakan: jika kunci API atau proyek Google Cloud dibuat dengan ikatan ke wilayah penagihan tertentu, perubahan IP proxy dapat menyebabkan ketidakcocokan antara lokasi yang diharapkan dan yang sebenarnya, dan Google kadang-kadang meminta verifikasi ulang melalui SMS atau email. Untuk mengurangi frekuensi pemeriksaan semacam itu, cobalah untuk menggunakan proxy dengan IP tetap (tidak diputar untuk setiap permintaan) dari negara yang sama — ini terlihat bagi sistem perlindungan Google sebagai perilaku pengguna biasa yang hanya tinggal di negara itu, bukan sebagai aktivitas mencurigakan.

Jika Anda bekerja dengan beberapa proyek atau kunci secara bersamaan dan menggunakan browser anti-detect seperti Dolphin Anty atau AdsPower untuk mengisolasi profil (relevan jika Anda menguji integrasi Gemini di berbagai lingkungan browser), ikatkan setiap profil dengan proxy terpisah dengan geolokasi tetap — ini mengurangi risiko bahwa satu proyek "menarik" kecurigaan karena IP campuran dari yang lain.

Juga tidak disarankan untuk menggunakan satu proxy gratis atau umum yang sama untuk Gemini dan pada saat yang sama untuk tugas lain dengan beban tinggi — sejumlah besar sesi paralel dari satu IP meningkatkan kemungkinan terkena batas laju atau pemblokiran sementara di tingkat Google, yang terlihat sama seperti masalah dengan wilayah, meskipun penyebabnya sama sekali berbeda.

Kesimpulan

Pembatasan Gemini CLI dan Gemini Code Assist berdasarkan wilayah diselesaikan di tingkat jaringan: proxy perlu ditetapkan secara bersamaan di variabel lingkungan sistem, di pengaturan VS Code, dan, saat menggunakan Google Cloud, di konfigurasi gcloud — hanya dengan cara itu ketiga titik masuk (CLI, ekstensi IDE, dan otorisasi OAuth) akan berfungsi melalui IP yang sama tanpa desinkronisasi. Sebelum bekerja secara penuh, selalu periksa koneksi dengan permintaan curl sederhana — ini menghemat jam untuk diagnosis ketika masalah sebenarnya bukan pada kode, tetapi di negara proxy.

Untuk pekerjaan harian yang stabil dengan Gemini CLI, yang paling cocok adalah proxy residensial dengan geolokasi tetap dan sesi sticky yang lama — mereka terlihat seperti IP rumah biasa dan jarang memicu pemeriksaan tambahan dari Google. Jika alamat residensial tetap masuk dalam geo-filter, sebaiknya coba proxy seluler, dan untuk pengujian API cepat sekali tanpa sesi panjang, cukup gunakan proxy data center.