Jika Anda membuka klien Codex, Codex CLI, atau aplikasi desktop ChatGPT untuk login, namun justru disambut dengan logo OpenAI berlatar putih dengan pesan "Ups, ada yang salah!" dan pop-up bertuliskan "Terjadi kesalahan saat verifikasi (unknown_country). Silakan coba lagi.", kemungkinan besar Anda sedang terjebak dalam masalah yang sama: Fakta bahwa ChatGPT versi web bisa diakses dengan lancar, tidak menjamin bahwa alamat IP jaringan Anda saat melakukan login klien telah diterima oleh OpenAI. Poin yang berlawanan dengan intuisi ini adalah akar penyebab mengapa kebanyakan orang menghabiskan waktu semalaman untuk mencoba berulang kali, membersihkan cache, hingga mengganti akun, namun tetap tidak bisa mengatasi error unknown_country.
Kode resmi untuk error ini sebenarnya bukan unknown_country, melainkan unsupported_country_region_territory. Masalah ini sudah banyak didokumentasikan di GitHub Issues dan komunitas pengembang OpenAI, di mana pemicunya selalu berpusat pada penolakan 403 di langkah https://auth.openai.com/oauth/token. Artikel ini akan menjelaskan mengapa hal tersebut terjadi, memberikan solusi proxy global + pemilihan wilayah IP yang bisa segera diverifikasi, dan diakhiri dengan rekomendasi dua layanan tepercaya untuk kebutuhan upgrade keanggotaan dan pengisian saldo API setelah berhasil login.
Mengapa error unknown_country muncul: Mekanisme verifikasi dua tahap pada klien Codex
Untuk memahami error ini, kita harus melihat apa yang sebenarnya dilakukan oleh klien Codex saat login. Ini bukan sekadar permintaan jaringan biasa, melainkan alur standar OAuth 2.0 Authorization Code yang terbagi menjadi dua permintaan independen, masing-masing melalui jalur jaringan yang berbeda. Tahap pertama adalah pengalihan browser ke auth.openai.com untuk menyelesaikan otorisasi akun, dan tahap kedua adalah klien mengambil kode otorisasi tersebut untuk ditukarkan dengan access token yang sebenarnya di https://auth.openai.com/oauth/token. Masalah terjadi pada tahap kedua, bukan tahap pertama.
| Tahap | Jalur | Konten Verifikasi | Titik Error |
|---|---|---|---|
| Tahap 1: Otorisasi | Browser default sistem | Akun/Kata sandi / 2FA | Biasanya berhasil |
| Tahap 2: Penukaran Token | Fetch proses klien | Apakah IP klien di wilayah dukungan OpenAI | Memicu unknown_country |
| Callback | 127.0.0.1 lokal | Parsing parameter URL | Biasanya normal |
Masalah utamanya adalah permintaan otorisasi tahap pertama dilakukan oleh browser, yang menggunakan proxy sistem, itulah sebabnya ChatGPT versi web Anda bisa dibuka dengan normal. Namun, permintaan penukaran token tahap kedua dilakukan langsung oleh proses klien Codex. Berdasarkan pengujian di beberapa GitHub Issue (openai/codex#14215, openai/codex#6849), klien Codex pada versi tertentu tidak secara ketat mewarisi variabel lingkungan seperti HTTPS_PROXY, sehingga langsung menggunakan jalur keluar jaringan default sistem. Karena IP keluar jaringan di Tiongkok daratan tidak termasuk dalam daftar negara/wilayah yang didukung OpenAI, maka muncul respons 403 unsupported_country_region_territory, yang akhirnya ditampilkan di pop-up klien sebagai "Terjadi kesalahan saat verifikasi (unknown_country)".
Inilah alasan mengapa banyak pengguna terjebak dalam siklus "web bisa digunakan, tapi klien tidak bisa login". Web menggunakan proxy browser, sementara klien menggunakan jalur keluar sistem; keduanya bisa jadi melalui jalur yang berbeda. Cara termudah untuk memastikannya adalah dengan membuka browser dan mengakses ipinfo.io atau ip.sb saat klien menampilkan error. Jika negara yang muncul bukan Singapura/Taiwan/AS/Jepang atau wilayah lain yang didukung OpenAI, maka itulah penyebab pastinya.
Langkah Praktis Menggunakan Proksi Global untuk Mengatasi Error unknown_country pada Codex
Inti dari perbaikan error ini sangat sederhana: Pastikan permintaan yang dikirim oleh proses klien juga melewati proksi yang memiliki akses ke wilayah yang didukung. Cara paling aman adalah dengan mengaktifkan "Proksi Global" (mode Global / TUN), sehingga semua proses dipaksa melewati proksi, bukan hanya browser saja. Tabel di bawah merangkum langkah-langkah untuk macOS dan Windows.
| Sistem Operasi | Metode yang Disarankan | Pengaturan Kunci | Metode Verifikasi |
|---|---|---|---|
| macOS | Aktifkan mode TUN atau Proksi Global | Klien Proksi → Mode Global / TUN | curl ipinfo.io menampilkan IP wilayah yang didukung |
| Windows | Aktifkan mode TUN (kartu jaringan virtual) | Klien Proksi → TUN | ipconfig + ipinfo.io untuk verifikasi ganda |
| Tambahan Umum | Variabel lingkungan terminal (opsional) | export HTTPS_PROXY dan HTTP_PROXY | Konfirmasi dengan perintah env |
Disarankan untuk mengikuti urutan langkah berikut. Pertama, ubah mode di klien proksi Anda dari "Mode Aturan" atau "Mode PAC" ke "Mode Global" atau aktifkan TUN. Kedua, pilih node dengan lokasi keluar di Singapura, Taiwan, Amerika Serikat, atau Jepang, karena wilayah-wilayah ini termasuk dalam daftar resmi yang didukung OpenAI. Ketiga, tutup sepenuhnya proses klien Codex (di macOS gunakan ⌘+Q, di Windows gunakan Task Manager untuk menghentikan proses terkait), jangan hanya menutup jendelanya. Keempat, jalankan kembali klien Codex dan klik login. Kali ini, proses penukaran OAuth Token akan melewati jalur proksi, dan error unknown_country akan hilang.
Jika Anda menggunakan Codex CLI dan bukan klien grafis, Anda juga dapat mengatur variabel lingkungan berikut di shell sebelum memulai login, karena beberapa versi CLI akan membaca nilai-nilai ini.
export HTTPS_PROXY="http://127.0.0.1:7890"
export HTTP_PROXY="http://127.0.0.1:7890"
export NO_PROXY="localhost,127.0.0.1"
codex login
Perlu diingat bahwa perilaku variabel lingkungan mungkin berbeda di setiap versi Codex. Dokumentasi resmi OpenAI menyarankan penggunaan login device code jika Anda mengalami masalah pada alur OAuth: jalankan codex login --device-auth. Anda akan mendapatkan kode sekali pakai dan URL; tempelkan kode tersebut ke perangkat mana pun yang dapat mengakses OpenAI untuk menyelesaikan verifikasi. Jalur ini melewati proses penukaran token oleh klien, sehingga memiliki tingkat keberhasilan tertinggi saat lingkungan jaringan sedang bermasalah.
🎯 Daftar Periksa Verifikasi Cepat: Aktifkan proksi global → Kunjungi ipinfo.io di browser untuk memastikan IP bukan dari wilayah yang diblokir → Tutup sepenuhnya klien Codex → Mulai ulang → Coba login kembali. Metode empat langkah ini menyelesaikan lebih dari 90% error unknown_country pada Codex.
Strategi Pemilihan Wilayah IP untuk Error "unknown_country" pada Codex
Daftar wilayah yang didukung secara resmi oleh OpenAI mencakup lebih dari 100 negara dan wilayah, namun Tiongkok daratan, Hong Kong, Rusia, Iran, dan beberapa wilayah lainnya tidak termasuk di dalamnya. Bagi pengguna di Tiongkok, hanya ada 4 wilayah yang paling praktis untuk dipilih: Singapura, Taiwan, Amerika Serikat, dan Jepang. Gambar perbandingan di bawah ini menunjukkan kandidat wilayah tersebut, dengan fokus utama pada latensi, stabilitas, dan kapasitas node saat memilih.
| Wilayah IP | Dukungan OpenAI | Latensi Terukur | Kapasitas Node | Skenario Rekomendasi |
|---|---|---|---|---|
| Singapura | ✅ Didukung | Rendah | Besar | Pilihan utama, latensi stabil |
| Taiwan | ✅ Didukung | Terendah | Sedang | Jarak fisik terdekat |
| Amerika | ✅ Didukung | Tinggi | Sangat Besar | Fitur model paling awal tersedia |
| Jepang | ✅ Didukung | Rendah | Sedang | Cadangan node stabil |
| Hong Kong | ❌ Tidak | Terendah | Besar | ⚠ Jangan gunakan, akan error lagi |
Kesalahan yang paling sering terjadi dalam praktik adalah penggunaan node Hong Kong. Karena lokasi fisiknya dekat dan latensinya rendah, banyak klien proxy merekomendasikan node Hong Kong secara default. Namun, OpenAI memasukkan Hong Kong ke dalam wilayah yang tidak didukung, sehingga penggunaan node ini tetap akan memicu unknown_country. Cara pengecekan yang mudah adalah dengan mengunjungi chat.openai.com melalui browser. Jika muncul pesan "Access denied" atau peringatan pemblokiran serupa, berarti IP keluar Anda berada di wilayah yang tidak didukung dan Anda perlu mengganti node.
| Prinsip Pemilihan | Prioritas | Penjelasan |
|---|---|---|
| Apakah didukung OpenAI | Wajib | Tidak dalam daftar pasti gagal |
| Stabilitas node (tidak sering putus) | Tinggi | Mempengaruhi stabilitas percakapan setelah login |
| Latensi | Sedang | Berhubungan dengan kecepatan respons, tidak mempengaruhi login |
| Kapasitas node (tidak padat) | Sedang | Berpengaruh signifikan saat jam sibuk |
Jika klien proxy Anda sering berganti node, kami sarankan untuk menetapkan satu node Singapura atau Taiwan di file konfigurasi khusus untuk lalu lintas OpenAI, sementara lalu lintas lainnya mengikuti aturan pencocokan. Ini memastikan login Codex tetap stabil tanpa memperlambat layanan video atau layanan domestik lainnya.
Solusi Setelah Login Codex: Rekomendasi Upgrade Keanggotaan ChatGPT dan Pengisian Saldo API
Banyak orang yang setelah berhasil mengatasi error unknown_country pada Codex akan langsung menghadapi masalah berikutnya: meskipun klien seperti Codex bisa login, untuk mengeluarkan kemampuan penuhnya (Codex Cloud, kuota ChatGPT Plus/Pro, izin model Pro) sering kali memerlukan keanggotaan berbayar. Sementara itu, keanggotaan ChatGPT hanya menerima kartu kredit luar negeri atau PayPal, dan metode pembayaran utama di Tiongkok langsung ditolak. Begitu pula jika Anda ingin menggunakan API OpenAI untuk bisnis, pengisian saldo API juga memerlukan kartu kredit luar negeri. Langkah ini menjadi hambatan besar bagi pengguna yang tidak memiliki kartu luar negeri.
Untuk kedua kebutuhan ini, ada dua layanan perantara lama di industri yang memiliki reputasi baik. Mereka terus menjaga ketersediaan layanan selama dua tahun terakhir di tengah perubahan kebijakan OpenAI yang sering terjadi, sehingga layak dijadikan pilihan utama.
| Situs Layanan | Skenario Utama | Target Pengguna |
|---|---|---|
| Situs Upgrade AI: ai.daishengji.com | Upgrade ChatGPT Plus / Pro / Team / Edu, dll. | Individu & tim yang tidak punya kartu kredit luar negeri |
| Situs Isi Saldo GPT: www.gpt516.com | Isi saldo API OpenAI, keanggotaan ChatGPT | Pengembang yang butuh saldo API stabil |
| APIYI apiyi.com | API Multimodal satu pintu | Pengembang yang butuh GPT-5.5 / Claude / Gemini |
🎯 Saran Upgrade Keanggotaan: Jika tujuan Anda adalah menggunakan kuota Plus/Pro di aplikasi resmi seperti klien ChatGPT, klien Codex, atau Sora, prioritaskan mengunjungi situs upgrade AI:
ai.daishengji.com. Mereka sudah lama berkecimpung di bidang ini dengan proses yang terstandarisasi. Jika Anda membutuhkan saldo API resmi OpenAI, Anda bisa memilih situs pengisian saldo GPT:www.gpt516.comyang sudah beroperasi lama dengan respons komunikasi yang stabil.
🎯 Saran Jalur Alternatif: Jika Anda hanya ingin memanggil model seri OpenAI di aplikasi sendiri, Anda tidak memerlukan keanggotaan ChatGPT. Anda bisa langsung menggunakan platform APIYI
apiyi.comuntuk melakukan pembayaran dalam Rupiah (atau mata uang lokal) guna memanggil model seperti GPT-5.5, Claude 4.7 Opus, atau Gemini 3.1 Pro. Ini sepenuhnya melewati hambatan upgrade keanggotaan ChatGPT dan pengisian saldo API OpenAI, menjadikannya jalur paling praktis bagi pengembang.
FAQ Masalah Umum Login Codex: unknown_country
Q1: Saya sudah menyalakan proxy, kenapa masih muncul error unknown_country?
Ada tiga penyebab paling umum: Pertama, proxy Anda berada dalam "Mode Aturan" (Rule Mode) dan bukan "Mode Global / TUN", sehingga permintaan OAuth Token dari proses klien Codex tidak melewati proxy. Kedua, Anda memilih node Hong Kong, yang tidak termasuk dalam wilayah dukungan OpenAI. Ketiga, proses klien Codex belum dimatikan sepenuhnya sebelum dimulai ulang, sehingga proses lama masih menggunakan konfigurasi jaringan yang lama. Disarankan untuk memeriksa langkah-langkahnya satu per satu sesuai metode empat langkah di bagian kedua artikel ini.
Q2: Bisakah saya tidak menggunakan proxy global dan hanya mengarahkan Codex melalui proxy?
Bisa, tetapi perlakuannya berbeda tergantung jenis klien. Untuk Codex CLI, Anda bisa menjalankan export HTTPS_PROXY dan HTTP_PROXY sebelum memulai login; beberapa versi dapat mengenalinya. Untuk klien grafis Codex, disarankan untuk langsung menggunakan proxy global karena dukungan klien terhadap variabel lingkungan tidak konsisten. Proxy global adalah cara yang paling aman.
Q3: Mengapa ChatGPT di browser saya selalu bisa digunakan, tetapi klien Codex tidak bisa login?
Karena browser menggunakan proxy sistem atau pengaturan proxy bawaan browser, sedangkan proses klien Codex pada beberapa versi tidak secara otomatis mewarisi pengaturan proxy yang sama. Ini adalah jebakan "dua jalur jaringan" yang klasik; bagian pertama artikel ini menjelaskan hal tersebut secara mendetail.
Q4: Jika saya benar-benar tidak bisa mengatasi masalah jaringan, apakah ada alternatif yang lebih mudah?
Ada dua cara. Pertama, gunakan situs layanan peningkatan AI berbayar: ai.daishengji.com untuk menyelesaikan peningkatan ChatGPT Plus atau Pro, lalu lanjutkan menggunakan produk resmi seperti klien Codex. Kedua, lewati klien resmi sepenuhnya dengan menggunakan platform APIYI (apiyi.com) untuk melakukan pemanggilan model API seri OpenAI, yang sama sekali tidak memerlukan akun ChatGPT atau proxy global.
Q5: Bagaimana cara menggunakan metode login device code?
Untuk Codex CLI, jalankan codex login --device-auth untuk mendapatkan kode sekali pakai dan URL. Tempelkan kode tersebut ke perangkat apa pun yang sudah bisa mengakses OpenAI (misalnya komputer teman di luar negeri) untuk menyelesaikan verifikasi. Mesin lokal Anda tidak perlu terhubung langsung ke OpenAI, sehingga tingkat keberhasilannya paling tinggi saat lingkungan jaringan sedang rumit. Ini adalah solusi cadangan yang direkomendasikan secara resmi oleh OpenAI.
Q6: Bisakah saya menggunakan kartu kredit domestik untuk mengisi saldo API OpenAI?
Tidak bisa. Pengisian saldo API OpenAI memerlukan kartu kredit yang mendukung penyelesaian transaksi luar negeri atau PayPal. Jika Anda hanya memiliki kartu domestik, disarankan untuk menggunakan situs pengisian saldo GPT tepercaya: www.gpt516.com, atau langsung menggunakan platform APIYI (apiyi.com) untuk melakukan pemanggilan model OpenAI dengan pembayaran dalam Rupiah.
Kesimpulan: Jalur Penyelesaian Lengkap untuk Error unknown_country pada Codex
Munculnya pesan "Terjadi kesalahan selama verifikasi (unknown_country)" pada klien Codex bukanlah masalah akun, melainkan IP keluar jaringan Anda tidak diterima oleh OpenAI pada tahap penukaran OAuth Token. Kunci perbaikannya adalah kombinasi "Proxy Global + IP Wilayah yang Didukung", bukan dengan mencoba berulang kali atau membersihkan cache. Singapura, Taiwan, Amerika Serikat, dan Jepang adalah 4 opsi keluar yang paling aman saat ini. Meskipun Hong Kong memiliki latensi terendah, wilayah tersebut terdaftar sebagai wilayah yang tidak didukung, jadi jangan pernah memilihnya.
Jika setelah login Anda masih memerlukan keanggotaan ChatGPT Plus / Pro atau saldo API OpenAI, Anda bisa langsung menggunakan dua layanan tepercaya: situs peningkatan AI: ai.daishengji.com untuk menyelesaikan peningkatan keanggotaan, dan situs pengisian saldo GPT tepercaya: www.gpt516.com untuk mengisi saldo API. Jika tujuan Anda hanya untuk menggunakan API model seperti GPT-5.5, Claude 4.7 Opus, dan lainnya tanpa memerlukan keanggotaan ChatGPT, maka APIYI (apiyi.com) adalah jalur paling sederhana untuk melewati semua masalah pembayaran lintas negara dan proxy.
Tim Teknis APIYI · Fokus pada konten praktis mengenai API Model Bahasa Besar dan alat pengembang. Untuk artikel teknis lainnya, silakan kunjungi apiyi.com
