OpenAI unterstützt offiziell Dutzende von Ländern nicht – darunter Russland, Weißrussland, Iran und eine Reihe anderer Regionen.
Wenn Sie versuchen, codex
aus solchen Standorten zu starten, erhalten Sie entweder eine direkte Blockierung aufgrund der Geolokalisierung, eine Ablehnung der API-Schlüsselvergabe
oder eine instabile Verbindung mit ständigen Unterbrechungen bei der Ausführung von Cloud-Aufgaben. Dies kann durch einen
richtig ausgewählten und konfigurierten Proxy-Server gelöst werden – aber hier sind die Feinheiten wichtig: Nicht jeder Proxytyp
eignet sich für CLI-Tools und langwierige Hintergrundprozesse.
Warum Codex in Ihrem Land blockiert wird
OpenAI wendet Geoblocking auf mehreren Ebenen gleichzeitig an. Zunächst wird die IP-Adresse
bei jeder Anfrage an die API überprüft – wenn sie zu einem Land aus der Liste der nicht unterstützten Länder gehört, gibt der Server
den Fehler 403 Country, region, or territory not supported zurück.
Zweitens vergleicht das System bei der Registrierung eines Kontos und der Verknüpfung einer Kreditkarte die Geolokalisierung der IP,
die Rechnungsadresse der Karte und die Zeitzone des Geräts – Abweichungen erhöhen das Risiko einer Kontosperrung.
Drittens können selbst nach erfolgreicher Registrierung die CLI-Sitzungen unterbrochen werden, wenn die IP plötzlich
die geographische Zugehörigkeit mitten in einer Aufgabe ändert – dies ist typisch für dynamische IPs von Mobilfunkanbietern oder
bei der Verwendung kostenloser VPNs mit instabilen Adresspools.
Für Entwickler, die Codex CLI in Verbindung mit Automatisierung verwenden – beim Schreiben von Code, Überprüfen von Pull-Requests, Generieren von Tests in CI-Pipelines – bedeutet jede Unterbrechung der Verbindung, dass die Aufgabe mitten in der Ausführung abgebrochen wird. Daher ist es wichtig, nicht nur "die Blockade zu umgehen", sondern eine stabile IP mit der richtigen Geolokalisierung für die gesamte Dauer der Arbeit zu gewährleisten.
Welcher Proxytyp für Codex CLI benötigt wird
Für die Arbeit mit der OpenAI API und CLI-Tools, die darauf basieren, sind drei Parameter entscheidend: Stabilität der Sitzung (die IP sollte nicht mitten in der Anfrage wechseln), Reaktionsgeschwindigkeit und die Sauberkeit des Rufes der Adresse (ob sie auf den schwarzen Listen von Missbrauchsdiensten steht). Lassen Sie uns die Optionen durchgehen:
| Proxytyp | Für Codex CLI | Sitzungsstabilität | Geschwindigkeit |
|---|---|---|---|
| Wohnproxys | Ja, die Hauptwahl | Hoch (sticky-Sitzungen) | Mittel-hoch |
| Rechenzentrums-Proxys | Geeignet für CI/CD und Scraping | Sehr hoch (feste IP) | Maximal |
| Mobile Proxys | Überflüssig für API-Aufgaben | Mittel (Operator-Rotation) | Mittel |
Für die meisten Szenarien – lokale Entwicklung, persönliches CLI, unregelmäßige API-Anfragen – sind am besten Wohnproxys geeignet, die an eine IP pro Sitzung gebunden sind (sticky session). Sie geben reale IPs von lokalen Anbietern im gewählten Land aus, was das Risiko verringert, unter die Filter der Missbrauchserkennung von OpenAI zu fallen. Wenn Codex jedoch in einer Cloud-Pipeline mit vielen parallelen Aufgaben gestartet wird – zum Beispiel bei der automatischen Überprüfung von Dutzenden von Repositories – ist es vorteilhafter, Rechenzentrums-Proxys zu verwenden: Sie sind schneller und stabiler und halten lange Verbindungen ohne Verzögerungsschwankungen.
Proxy in Codex CLI über Umgebungsvariablen einrichten
Codex CLI respektiert, wie die meisten modernen Node.js- und Python-Tools, die Standard-Umgebungsvariablen HTTP_PROXY
und HTTPS_PROXY.
Dies ist der einfachste Weg, um den gesamten CLI-Verkehr über einen Proxy zu leiten, ohne die Konfigurationen der Anwendung zu ändern.
# 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"
# Überprüfung vor dem Start von Codex
curl -x $HTTPS_PROXY https://api.openai.com/v1/models
# Start CLI
codex "schreibe einen Unit-Test für die Funktion validateEmail"
# Windows PowerShell
$env:HTTP_PROXY = "http://login:password@proxy_host:port"
$env:HTTPS_PROXY = "http://login:password@proxy_host:port"
# Verbindungsprüfung
Invoke-WebRequest -Uri "https://api.openai.com/v1/models" -Proxy $env:HTTPS_PROXY
codex "refaktoriere dieses Modul"
Wenn der Proxy eine Authentifizierung mit Benutzername und Passwort erfordert (die meisten Anbieter arbeiten genau
so), geben Sie diese direkt in der Proxy-URL im Format
http://user:pass@host:port an.
Für SOCKS5-Proxys verwenden Sie das Protokoll socks5://
anstelle von http:// —
das ist wichtig, da einige CLI-Tools die Protokolle unterscheiden und eine falsch angegebene Schema ignorieren können.
Proxy über Konfigurationsdatei und Python-Wrapper
Wenn Sie eigene Skripte rund um die OpenAI API schreiben (zum Beispiel Batchverarbeitung von Aufgaben über
openai-python
SDK), können Umgebungsvariablen nicht ausreichen – manchmal ist es bequemer, den Proxy explizit an den Client zu übergeben.
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": "Generiere eine Datenbankmigration"}]
)
print(response.choices[0].message.content)
Für Node.js-Wrapper (wenn Ihre Codex-Pipeline auf JS basiert) gilt eine ähnliche Logik über
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: 'Überprüfe den Code auf Schwachstellen' }],
});
console.log(res.choices[0].message.content);
};
run();
Die explizite Übergabe des Proxys im Code ist nützlich, wenn ein Teil der Anfragen in Ihrer Anwendung direkt gehen soll (interne Dienste), während ein anderer Teil über den Proxy (Anfragen an OpenAI) läuft. So brechen Sie nicht die übrige Netzwerklogik der Anwendung mit globalen Umgebungsvariablen.
Proxy für Cloud-Aufgaben: Docker, CI/CD, GitHub Actions
Wenn Codex nicht lokal, sondern in einer automatisierten Pipeline verwendet wird – Codeüberprüfung bei jedem Pull-Request, nächtliche Dokumentationserstellung, automatisches Refactoring – muss der Proxy auf der Ebene der Ausführungsumgebung der Aufgabe angegeben werden, nicht nur im Terminal des Entwicklers.
# 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
Für CI/CD ist eine feste statische IP vorzuziehen – das ist genau das Szenario, in dem Rechenzentrums-Proxys sich besser als Wohnproxys zeigen: die Latenz ist niedriger, die Verbindung bricht bei langen Jobs nicht ab, und die Kosten für den Datenverkehr sind bei großen Anfragen deutlich niedriger. Bewahren Sie die Proxy-Geheimnisse (Benutzername, Passwort, Host) unbedingt in den Secrets des Repositories auf und nicht in der Workflow-Datei selbst.
IP-Rotation und Stabilität langer Sitzungen
Der größte Fehler bei der Arbeit mit Codex über einen Proxy ist die Verwendung von IPs mit automatischer Rotation bei jeder Anfrage im Rahmen einer mehrstufigen Aufgabe. Die OpenAI API unterstützt lange Streaming-Antworten und aufeinanderfolgende Aufrufe im Rahmen eines Kontexts – wenn sich die ausgehende IP zwischen diesen Aufrufen ändert, kann der Dienst dies als verdächtige Aktivität werten oder einfach die Streaming-Verbindung trennen.
Die Lösung sind sticky-Sitzungen: Der Proxy hält dieselbe IP für Ihre Verbindung über einen festgelegten Zeitraum (normalerweise zwischen 1 und 30 Minuten, je nach den Einstellungen des Anbieters) und wechselt sie dann gegen eine neue. Für Codex CLI ist es optimal, die Sitzungsdauer nicht kürzer als die Dauer Ihrer längsten Aufgabe festzulegen – wenn die Generierung eines großen PRs 5 Minuten dauert, sollte die Sitzung mindestens 10-15 Minuten mit Puffer bestehen bleiben.
# Beispiel für die Bildung einer sticky-Sitzung über einen Parameter im Proxy-Login
# (Syntax hängt vom Anbieter ab, typischerweise wie folgt)
export HTTPS_PROXY="http://user-session-abc123:password@proxy_host:port"
Wenn Aufgaben parallel in CI ausgeführt werden (zum Beispiel die Überprüfung von 10 Pull-Requests gleichzeitig), sollte jeder parallelen Job eine separate Session-ID zugewiesen werden – so vermeiden Sie Situationen, in denen mehrere Prozesse gleichzeitig dieselbe IP „abfragen“ und früher als nötig auf das API-Rate-Limit stoßen.
Häufige Fehler und wie man sie behebt
Lassen Sie uns typische Probleme durchgehen, mit denen Entwickler bei der Einrichtung von Proxys für Codex CLI und die OpenAI API konfrontiert sind.
| Fehler | Ursache | Lösung |
|---|---|---|
403 unsupported_country_region_territory |
Der Proxy wurde nicht verwendet, die Anfrage ging mit der echten IP | Überprüfen Sie die Umgebungsvariablen mit curl -x |
| Stream bricht mitten in der Antwort ab | Die IP hat sich mitten in der Sitzung geändert (kein sticky-Modus) | Aktivieren Sie die sticky-Sitzung, erhöhen Sie die Lebensdauer der IP |
| Timeout / Verbindung abgelehnt | Falscher Port oder Protokoll (http anstelle von socks5) | Überprüfen Sie das Protokoll und den Port in der Dokumentation des Proxy-Anbieters |
| Rate-Limit tritt zu schnell ein | Mehrere Prozesse verwenden gleichzeitig eine IP | Weisen Sie jeder parallelen Prozess eine separate Session-ID zu |
| Das Konto hat eine Warnung wegen verdächtiger Aktivität erhalten | Die IP des Rechenzentrums ist in die Missbrauchsdatenbank geraten | Wechseln Sie zu einer Wohn-IP mit gutem Ruf |
Checkliste vor dem Start
Bevor Sie Codex CLI eine produktive Aufgabe über einen Proxy anvertrauen, gehen Sie die kurze Liste durch:
- Verfügbarkeit von
api.openai.comübercurl -xmit Ihrem Proxy überprüft - Geolokalisierung des Proxys stimmt mit dem Land überein, das im Billing-Konto von OpenAI angegeben ist
- Sticky-Sitzung mit einer Lebensdauer aktiviert, die länger ist als die Dauer der längsten Aufgabe
- Für CI/CD sind die Proxy-Geheimnisse in Secrets ausgegliedert und nicht im Code des Workflows gespeichert
- Für parallele Aufgaben werden verschiedene Session-IDs verwendet, nicht eine gemeinsame IP
- CLI-Logs auf versteckte direkte Anfragen überprüft, die den Proxy umgehen (z. B. von externen Abhängigkeiten)
Fazit
Die Arbeit mit OpenAI Codex CLI aus einem Land ohne offizielle Unterstützung erfordert nicht nur einen einmaligen Umgehungsversuch, sondern eine systematische Netzwerkkonfiguration: den richtigen Proxytyp, sticky-Sitzungen für lange Anfragen und eine sorgfältige Integration in Umgebungsvariablen oder den Client-Code. Für die lokale Entwicklung und unregelmäßige Aufgaben sind Wohn-IP-Adressen mit gutem Ruf am besten geeignet, während für stark belastete CI/CD-Pipelines schnelle und stabile Rechenzentrums-Proxys bevorzugt werden sollten.
Wenn Sie planen, Codex und andere Tools auf Basis der OpenAI API aus einer Region ohne offizielle Unterstützung zu starten, empfehlen wir, mit Wohnproxys für einen stabilen Betrieb des CLI zu beginnen, und für umfangreiche automatisierte Aufgaben in der Cloud — mit Rechenzentrums-Proxys, die niedrige Latenz und vorhersehbare Kosten bei großen Anfragen an die API gewährleisten.