OpenAI, Rusya, Belarus, İran ve diğer bazı bölgeler dahil olmak üzere birçok ülkeyi resmi olarak desteklemiyor.
Bu tür konumlardan codex
çalıştırmaya çalıştığınızda ya coğrafi konum nedeniyle doğrudan bir engelleme alırsınız ya da API anahtarı verilmez,
ya da bulut görevlerini yerine getirirken sürekli kopmalarla birlikte kararsız bir bağlantı yaşarsınız. Bu durum,
doğru bir şekilde seçilmiş ve yapılandırılmış bir proxy sunucusu ile çözülebilir - ancak burada önemli detaylar var: her proxy türü
CLI araçları ve uzun arka plan süreçleri için uygun değildir.
Codex neden ülkenizde engelleniyor
OpenAI, birden fazla seviyede coğrafi engellemeler uyguluyor. Öncelikle, API'ye her istek yapıldığında IP adresi kontrol ediliyor -
eğer desteklenmeyen ülkeler listesine ait bir IP ise, sunucu 403 Ülke, bölge veya alan desteklenmiyor hatasını döndürüyor.
İkincisi, bir hesap kaydı oluşturulurken ve ödeme kartı bağlanırken sistem, IP'nin coğrafi konumunu,
kartın fatura adresini ve cihazın saat dilimini kontrol ediyor - tutarsızlıklar hesap blokajı riskini artırıyor.
Üçüncüsü, başarılı bir kayıt sonrasında bile CLI oturumları kopabilir, eğer IP aniden
görev ortasında coğrafi konumunu değiştirirse - bu, mobil operatörlerin dinamik IP'leri için tipik bir durumdur veya
kararsız bir IP havuzu ile ücretsiz VPN kullanıldığında meydana gelir.
Codex CLI'yi otomasyon ile birlikte kullanan geliştiriciler için - kod yazma, pull isteklerinin gözden geçirilmesi, CI boru hattında testlerin üretilmesi - bağlantı kopması, görevlerin ortasında düşmesi anlamına gelir. Bu nedenle, sadece "engeli aşmak" değil, çalışma süresi boyunca doğru coğrafi konumda kararlı bir IP sağlamak önemlidir.
Codex CLI için hangi tür proxy gerekiyor
OpenAI API ve onun üzerine kurulu CLI araçları için üç parametre kritik öneme sahiptir: oturum kararlılığı (IP, istek ortasında değişmemelidir), yanıt hızı ve adresin itibar temizliği (kara listelerde olup olmadığı). Seçenekleri inceleyelim:
| Proxy Türü | Codex CLI için | Oturum Kararlılığı | Hız |
|---|---|---|---|
| Konut Proxy'leri | Evet, ana seçim | Yüksek (sticky oturumlar) | Orta-yüksek |
| Veri Merkezi Proxy'leri | CI/CD ve veri çekme için uygundur | Çok yüksek (sabit IP) | Maksimum |
| Mobil Proxy'ler | API görevleri için gereksiz | Orta (operatör rotasyonu) | Orta |
Çoğu senaryo için - yerel geliştirme, kişisel CLI, düzensiz API istekleri - en iyi konut proxy'leri bir oturumda bir IP'ye bağlı (sticky session) olarak en uygun olanlardır. Seçilen ülkedeki ev sağlayıcılarının gerçek IP'lerini verirler, bu da OpenAI'nin kötüye kullanım tespit filtrelerine takılma riskini azaltır. Ancak Codex bulut boru hattında çok sayıda paralel görevle çalıştırılıyorsa - örneğin, onlardan birçoğunun otomatik gözden geçirilmesi - veri merkezi proxy'leri kullanmak daha avantajlıdır: daha hızlıdırlar ve uzun bağlantıları gecikme dalgalanmaları olmadan daha kararlı tutarlar.
Codex CLI'de çevresel değişkenler aracılığıyla proxy ayarlama
Codex CLI, çoğu modern Node.js ve Python aracında olduğu gibi, standart
çevresel değişkenleri HTTP_PROXY
ve HTTPS_PROXY dikkate alır.
Bu, tüm CLI trafiğini uygulama yapılandırmalarını düzenlemeden proxy üzerinden yönlendirmek için en basit yoldur.
# 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"
# Codex'i başlatmadan önce kontrol
curl -x $HTTPS_PROXY https://api.openai.com/v1/models
# CLI'yi başlat
codex "validateEmail fonksiyonu için birim testi yaz"
# Windows PowerShell
$env:HTTP_PROXY = "http://login:password@proxy_host:port"
$env:HTTPS_PROXY = "http://login:password@proxy_host:port"
# Bağlantıyı kontrol et
Invoke-WebRequest -Uri "https://api.openai.com/v1/models" -Proxy $env:HTTPS_PROXY
codex "bu modülü yeniden yapılandır"
Eğer proxy, kullanıcı adı ve şifre ile kimlik doğrulama gerektiriyorsa (çoğu sağlayıcı böyle çalışır),
bunları doğrudan proxy URL'sinde
http://user:pass@host:port formatında belirtin.
SOCKS5 proxy için socks5://
protokolünü http:// yerine kullanın -
bu önemlidir, çünkü bazı CLI araçları protokolleri ayırt edebilir ve yanlış belirtilen şemayı göz ardı edebilir.
Konfigürasyon dosyası ve Python sarmalayıcıları aracılığıyla proxy
Eğer OpenAI API etrafında kendi scriptlerinizi yazıyorsanız (örneğin,
openai-python
SDK'sı aracılığıyla toplu görev işleme), çevresel değişkenler yetersiz kalabilir - bazen proxy'i
doğrudan istemciye iletmek daha kullanışlıdır.
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": "Veritabanı göçü oluştur"}]
)
print(response.choices[0].message.content)
Node.js sarmalayıcıları için (eğer Codex boru hattınız JS üzerine kurulmuşsa) benzer bir mantık
https-proxy-agent ile:
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: 'Kodu güvenlik açıkları için kontrol et' }],
});
console.log(res.choices[0].message.content);
};
run();
Proxy'i kodda açıkça iletmek, uygulamanızdaki bazı isteklerin doğrudan gitmesi gerektiği durumlarda (iç hizmetler) ve bazı isteklerin proxy üzerinden gitmesi gerektiği durumlarda faydalıdır (OpenAI'ye istekler). Böylece uygulamanızın diğer ağ mantığını küresel çevresel değişkenlerle bozmazsınız.
Bulut görevleri için proxy: Docker, CI/CD, GitHub Actions
Eğer Codex yerel olarak değil, otomatik bir boru hattında kullanılıyorsa - her pull request'te kod gözden geçirme, gece belgelerin oluşturulması, otomatik yeniden yapılandırma - proxy, görev yürütme ortamı seviyesinde belirtilmelidir, sadece geliştirici terminalinde değil.
# 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 İncelemesi
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: Codex'i Yükle
run: npm install -g @openai/codex
- name: Codex incelemesini çalıştır
run: codex review --diff origin/main
CI/CD için sabit statik bir IP tercih edilir - bu, veri merkezi proxy'lerinin konut proxy'lerine göre daha iyi performans gösterdiği bir senaryodur: gecikme daha düşüktür, bağlantı uzun görevlerde kopmaz ve büyük miktarda isteklerde trafik maliyeti belirgin şekilde daha düşüktür. Proxy'nin sırlarını (kullanıcı adı, şifre, host) mutlaka repository'nin Secrets bölümünde saklayın, workflow dosyasında değil.
IP rotasyonu ve uzun oturumların kararlılığı
Proxy aracılığıyla Codex ile çalışırken en büyük hata, her istekte otomatik IP rotasyonu kullanmaktır tek bir çok adımlı görev içinde. OpenAI API, uzun süreli akış yanıtlarını ve bir bağlam içinde ardışık çağrıları destekler - bu çağrılar arasında çıkış IP'si değişirse, servis bunu şüpheli bir aktivite olarak değerlendirebilir veya akış bağlantısını kesebilir.
Çözüm - sticky oturumlar: proxy, belirli bir süre boyunca (genellikle sağlayıcının ayarlarına bağlı olarak 1 ila 30 dakika arasında) bağlantınız için aynı IP'yi sabit tutar, ardından yeni bir IP ile değiştirir. Codex CLI için oturum süresini en uzun görevinizin süresinden az olmamak üzere ayarlamak en iyisidir - büyük bir PR oluşturma 5 dakika sürüyorsa, oturum en az 10-15 dakika boyunca açık kalmalıdır.
# Proxy'de oturum parametresi ile sticky oturum oluşturma örneği
# (sözdizimi sağlayıcıya bağlıdır, aşağıdaki tipik bir örnektir)
export HTTPS_PROXY="http://user-session-abc123:password@proxy_host:port"
Eğer görevler CI'de paralel olarak çalıştırılıyorsa (örneğin, aynı anda 10 pull request'in gözden geçirilmesi), her paralel iş için ayrı bir oturum kimliği vermek önemlidir - böylece birden fazla işlem aynı IP'yi "çekmeye" çalışırken API'nin hız limitine daha önce ulaşma durumunu önlersiniz.
Sık karşılaşılan hatalar ve bunları nasıl düzeltirsiniz
Geliştiricilerin Codex CLI ve OpenAI API için proxy ayarlarken karşılaştıkları tipik sorunları inceleyelim.
| Hata | Neden | Çözüm |
|---|---|---|
403 unsupported_country_region_territory |
Proxy devreye girmedi, istek gerçek IP ile gitti | Çevresel değişkenleri curl -x ile kontrol edin |
| Akış yanıtın ortasında kopuyor | IP oturum ortasında değişti (sticky modu yok) | Sticky oturumu etkinleştirin, IP'nin ömrünü artırın |
| Zaman aşımı / bağlantı reddedildi | Yanlış port veya protokol (http yerine socks5) | Proxy sağlayıcısının belgelerinde protokol ve portu kontrol edin |
| Hız limiti çok hızlı geliyor | Birden fazla işlem aynı IP'yi aynı anda kullanıyor | Her paralel işlem için ayrı oturum kimlikleri ayırın |
| Hesap şüpheli aktivite nedeniyle uyarı aldı | Veri merkezi IP'si kötüye kullanım veritabanına girdi | Temiz bir itibar ile konut IP'sine geçin |
Başlatmadan önce kontrol listesi
Codex CLI'ye bir görev vermeden önce kısa bir listeyi gözden geçirin:
api.openai.comerişilebilirliğini kendi proxy'nizlecurl -xile kontrol ettiniz mi?- Proxy'nin coğrafi konumu, OpenAI hesabının fatura adresiyle aynı ülkeyle örtüşüyor mu?
- Oturum süresi, en uzun görevin süresinden daha uzun olacak şekilde sticky oturum etkinleştirildi mi?
- CI/CD için proxy sırları Secrets'ta saklanıyor, workflow kodunda değil mi?
- Paralel görevler için farklı oturum kimlikleri kullanılıyor, tek bir ortak IP değil mi?
- CLI günlükleri, proxy'yi atlayarak gizli doğrudan istekler için kontrol edildi mi (örneğin, üçüncü taraf bağımlılıkları tarafından)?
Sonuç
OpenAI Codex CLI ile resmi desteklenmeyen bir ülkeden çalışmak, sadece engeli aşmakla değil, aynı zamanda ağı sistematik olarak yapılandırmakla ilgilidir: doğru proxy türü, uzun istekler için sticky oturumlar ve çevresel değişkenler veya istemci koduna dikkatli entegrasyon. Yerel geliştirme ve düzensiz görevler için temiz bir itibara sahip konut IP'leri en uygun olanlardır, yoğun CI/CD boru hatları için ise hızlı ve kararlı veri merkezi proxy'leri tercih edilmelidir.
Eğer Codex ve diğer OpenAI API tabanlı araçları resmi desteklenmeyen bir bölgeden çalıştırmayı planlıyorsanız, stabil CLI çalışması için konut proxy'leri ile başlamanızı öneririz, büyük ölçekli otomatik görevler için ise veri merkezi proxy'leri kullanarak düşük gecikme ve büyük API istekleri için öngörülebilir maliyet sağlayabilirsiniz.