OpenAI secara resmi tidak mendukung puluhan negara — termasuk Rusia, Belarus, Iran, dan sejumlah wilayah lainnya.
Saat mencoba menjalankan codex
dari lokasi-lokasi tersebut, Anda akan mendapatkan baik pemblokiran langsung berdasarkan geolokasi, atau penolakan untuk mendapatkan kunci API,
atau koneksi yang tidak stabil dengan pemutusan yang terus-menerus saat menjalankan tugas cloud. Ini dapat diatasi dengan
menggunakan server proxy yang dipilih dan dikonfigurasi dengan benar — tetapi di sini ada nuansa penting: tidak semua jenis proxy
cocok untuk alat CLI dan proses latar belakang yang berkepanjangan.
Mengapa Codex diblokir di negara Anda
OpenAI menerapkan pemblokiran geografis pada beberapa tingkat sekaligus. Pertama, alamat IP
diperiksa pada setiap permintaan ke API — jika alamat tersebut berasal dari negara yang terdaftar dalam daftar yang tidak didukung, server akan mengembalikan
kesalahan 403 Country, region, or territory not supported.
Kedua, saat mendaftar akun dan mengaitkan kartu pembayaran, sistem memeriksa geolokasi IP,
alamat penagihan kartu, dan zona waktu perangkat — perbedaan meningkatkan risiko pemblokiran akun.
Ketiga, bahkan setelah pendaftaran yang berhasil, sesi CLI dapat terputus jika IP tiba-tiba berubah
geolokasi di tengah tugas — ini biasanya terjadi pada IP dinamis dari operator seluler atau
saat menggunakan VPN gratis dengan kumpulan alamat yang tidak stabil.
Bagi pengembang yang menggunakan Codex CLI dalam kombinasi dengan otomatisasi — penulisan kode, peninjauan pull request, pembuatan tes dalam pipeline CI — setiap pemutusan koneksi berarti tugas yang terputus di tengah pelaksanaan. Oleh karena itu, penting untuk tidak hanya "menghindari pemblokiran", tetapi juga memastikan IP yang stabil dengan geolokasi yang benar selama periode kerja.
Jenis proxy apa yang dibutuhkan untuk Codex CLI
Untuk bekerja dengan API OpenAI dan alat CLI yang berbasis di atasnya, tiga parameter sangat penting: stabilitas sesi (IP tidak boleh berubah di tengah permintaan), kecepatan respons, dan reputasi alamat yang bersih (apakah alamat tersebut tidak terdaftar dalam daftar hitam layanan penyalahgunaan). Mari kita bahas opsi-opsinya:
| Jenis Proxy | Untuk Codex CLI | Stabilitas Sesi | Kecepatan |
|---|---|---|---|
| Proxy Residensial | Ya, pilihan utama | Tinggi (sesi lengket) | Sedang-tinggi |
| Proxy Pusat Data | Cocok untuk CI/CD dan pengambilan data | Sangat tinggi (IP tetap) | Maksimal |
| Proxy Seluler | Berlebihan untuk tugas API | Sedang (rotasi operator) | Sedang |
Untuk sebagian besar skenario — pengembangan lokal, CLI pribadi, permintaan API yang tidak teratur — yang paling cocok adalah proxy residensial dengan pengikatan satu IP per sesi (sesi lengket). Mereka memberikan IP nyata dari penyedia rumah di negara yang dipilih, yang mengurangi risiko terjebak dalam filter deteksi penyalahgunaan OpenAI. Namun, jika Codex dijalankan dalam pipeline cloud dengan banyak tugas paralel — misalnya, peninjauan otomatis puluhan repositori — lebih menguntungkan menggunakan proxy pusat data: mereka lebih cepat dan lebih stabil dalam menjaga koneksi jangka panjang tanpa lonjakan latensi.
Mengatur proxy di Codex CLI melalui variabel lingkungan
Codex CLI, seperti kebanyakan alat Node.js dan Python modern, menghormati variabel lingkungan standar
HTTP_PROXY
dan HTTPS_PROXY.
Ini adalah cara paling sederhana untuk mengarahkan semua lalu lintas CLI melalui proxy tanpa mengedit konfigurasi aplikasi.
# Linux / macOS (bash, zsh)
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"
# Memeriksa sebelum menjalankan Codex
curl -x $HTTPS_PROXY https://api.openai.com/v1/models
# Menjalankan CLI
codex "tulis unit test untuk fungsi validateEmail"
# Windows PowerShell
$env:HTTP_PROXY = "http://login:password@proxy_host:port"
$env:HTTPS_PROXY = "http://login:password@proxy_host:port"
# Memeriksa koneksi
Invoke-WebRequest -Uri "https://api.openai.com/v1/models" -Proxy $env:HTTPS_PROXY
codex "refactor modul ini"
Jika proxy memerlukan otentikasi dengan login dan kata sandi (kebanyakan penyedia bekerja seperti ini),
cantumkan langsung dalam URL proxy dalam format
http://user:pass@host:port.
Untuk proxy SOCKS5, gunakan protokol socks5://
sebagai ganti http:// —
ini penting, karena beberapa alat CLI membedakan protokol dan dapat mengabaikan skema yang salah
ditentukan.
Proxy melalui file konfigurasi dan pembungkus Python
Jika Anda menulis skrip sendiri di sekitar API OpenAI (misalnya, pemrosesan batch tugas melalui
openai-python
SDK), variabel lingkungan mungkin tidak cukup — terkadang lebih nyaman untuk secara eksplisit meneruskan proxy ke klien.
import httpx
from openai import OpenAI
proxy_url = "http://login:password@proxy_host:port"
client = OpenAI(
api_key="sk-...",
http_client=httpx.Client(proxies=proxy_url, timeout=60.0)
)
response = client.chat.completions.create(
model="gpt-4o",
messages=[{"role": "user", "content": "Buat migrasi basis data"}]
)
print(response.choices[0].message.content)
Untuk pembungkus Node.js (jika pipeline Codex Anda dibangun di JS) logika serupa melalui
https-proxy-agent:
const { HttpsProxyAgent } = require('https-proxy-agent');
const OpenAI = require('openai');
const agent = new HttpsProxyAgent('http://login:password@proxy_host:port');
const client = new OpenAI({
apiKey: process.env.OPENAI_API_KEY,
httpAgent: agent,
});
const run = async () => {
const res = await client.chat.completions.create({
model: 'gpt-4o',
messages: [{ role: 'user', content: 'Periksa kode untuk kerentanan' }],
});
console.log(res.choices[0].message.content);
};
run();
Mengirimkan proxy secara eksplisit dalam kode berguna ketika sebagian permintaan dalam aplikasi Anda harus dilakukan secara langsung (layanan internal), sementara sebagian — melalui proxy (permintaan ke OpenAI). Dengan cara ini, Anda tidak merusak logika jaringan lainnya dalam aplikasi dengan variabel lingkungan global.
Proxy untuk tugas cloud: Docker, CI/CD, GitHub Actions
Jika Codex digunakan tidak secara lokal, tetapi dalam pipeline otomatis — peninjauan kode pada setiap pull request, pembuatan dokumentasi malam, refactoring otomatis — proxy perlu ditentukan pada tingkat lingkungan pelaksanaan tugas, bukan hanya di terminal pengembang.
# Dockerfile
FROM node:20-slim
ENV HTTP_PROXY="http://login:password@proxy_host:port"
ENV HTTPS_PROXY="http://login:password@proxy_host:port"
ENV NO_PROXY="localhost,127.0.0.1"
RUN npm install -g @openai/codex
WORKDIR /app
COPY . .
CMD ["codex", "run", "review"]
# .github/workflows/codex-review.yml
name: Codex Review
on: [pull_request]
jobs:
review:
runs-on: ubuntu-latest
env:
HTTPS_PROXY: ${{ secrets.PROXY_URL }}
OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
steps:
- uses: actions/checkout@v4
- name: Install Codex
run: npm install -g @openai/codex
- name: Run Codex review
run: codex review --diff origin/main
Untuk CI/CD, lebih disukai menggunakan IP statis tetap — ini adalah skenario di mana proxy pusat data menunjukkan kinerja yang lebih baik dibandingkan proxy residensial: latensi lebih rendah, koneksi tidak terputus pada pekerjaan panjang, dan biaya lalu lintas untuk volume permintaan yang besar jauh lebih rendah. Simpan rahasia proxy (login, kata sandi, host) di Secrets repositori, bukan di file workflow itu sendiri.
Rotasi IP dan stabilitas sesi panjang
Kesalahan utama saat bekerja dengan Codex melalui proxy adalah menggunakan IP dengan rotasi otomatis pada setiap permintaan dalam satu tugas multi-langkah. OpenAI API mendukung respons streaming yang panjang dan panggilan berurutan dalam satu konteks — jika antara panggilan ini IP keluar berubah, layanan dapat menganggap ini sebagai aktivitas mencurigakan atau hanya memutuskan koneksi streaming.
Solusinya adalah sesi lengket: proxy mempertahankan satu IP yang sama terikat pada koneksi Anda untuk periode tertentu (biasanya dari 1 hingga 30 menit, tergantung pada pengaturan penyedia), setelah itu menggantinya dengan yang baru. Untuk Codex CLI, optimal untuk mengatur waktu sesi tidak kurang dari durasi tugas terpanjang Anda — jika pembuatan PR besar memakan waktu 5 menit, sesi harus bertahan setidaknya 10-15 menit sebagai cadangan.
# Contoh pembentukan sesi lengket melalui parameter dalam login proxy
# (sintaks tergantung pada penyedia, contoh umum di bawah ini)
export HTTPS_PROXY="http://user-session-abc123:password@proxy_host:port"
Jika tugas dijalankan secara paralel di CI (misalnya, meninjau 10 pull request sekaligus), setiap pekerjaan paralel harus diberikan ID sesi terpisah — dengan cara ini Anda menghindari situasi di mana beberapa proses secara bersamaan "menarik" IP yang sama dan mencapai batas laju API lebih cepat dari yang seharusnya.
Kesalahan umum dan cara memperbaikinya
Mari kita bahas masalah umum yang dihadapi pengembang saat mengatur proxy untuk Codex CLI dan API OpenAI.
| Kesalahan | Penyebab | Solusi |
|---|---|---|
403 unsupported_country_region_territory |
Proxy tidak terdeteksi, permintaan dikirim dengan IP asli | Periksa variabel lingkungan melalui curl -x |
| Stream terputus di tengah respons | IP berubah di tengah sesi (tidak ada mode lengket) | Aktifkan sesi lengket, tingkatkan waktu hidup IP |
| Timeout / koneksi ditolak | Port atau protokol salah (http alih-alih socks5) | Periksa protokol dan port dalam dokumentasi penyedia proxy |
| Batas laju tercapai terlalu cepat | Beberapa proses menggunakan satu IP secara bersamaan | Berikan ID sesi terpisah untuk setiap proses paralel |
| Akun menerima peringatan tentang aktivitas mencurigakan | IP pusat data masuk dalam basis data penyalahgunaan | Beralih ke IP residensial dengan reputasi bersih |
Daftar periksa sebelum menjalankan
Sebelum mempercayakan Codex CLI dengan tugas produksi melalui proxy, periksa daftar singkat berikut:
- Memeriksa ketersediaan
api.openai.commelaluicurl -xdengan proxy Anda - Geolokasi proxy sesuai dengan negara yang terdaftar di penagihan akun OpenAI
- Sesi lengket diaktifkan dengan waktu hidup lebih lama dari durasi tugas terpanjang
- Untuk CI/CD, rahasia proxy disimpan di Secrets, bukan dalam kode workflow
- Untuk tugas paralel, gunakan ID sesi yang berbeda, bukan satu IP umum
- Log CLI diperiksa untuk permintaan langsung tersembunyi yang menghindari proxy (misalnya, dari ketergantungan pihak ketiga)
Kesimpulan
Bekerja dengan OpenAI Codex CLI dari negara tanpa dukungan resmi memerlukan lebih dari sekadar menghindari pemblokiran, tetapi juga pengaturan jaringan yang sistematis: jenis proxy yang benar, sesi lengket untuk permintaan panjang, dan integrasi yang hati-hati dalam variabel lingkungan atau kode klien. Untuk pengembangan lokal dan tugas yang tidak teratur, IP residensial dengan reputasi bersih lebih cocok, sedangkan untuk pipeline CI/CD yang padat — proxy pusat data yang cepat dan stabil.
Jika Anda berencana untuk menjalankan Codex dan alat lain berbasis API OpenAI dari wilayah tanpa dukungan resmi, kami sarankan untuk memulai dengan proxy residensial untuk kinerja CLI yang stabil, dan untuk tugas otomatisasi besar di cloud — dengan proxy pusat data, yang akan memberikan latensi rendah dan biaya yang dapat diprediksi untuk volume permintaan besar ke API.