OpenAI non supporta ufficialmente decine di paesi, inclusi Russia, Bielorussia, Iran e diversi altri regioni.
Quando si tenta di avviare codex
da tali posizioni, si riceverà o un blocco diretto per geolocalizzazione, o un rifiuto nella fornitura della chiave API,
oppure una connessione instabile con interruzioni costanti durante l'esecuzione di compiti cloud. Questo può essere risolto
con un proxy server correttamente configurato — ma qui ci sono delle sfumature: non tutti i tipi di proxy
sono adatti per strumenti CLI e processi di lunga durata.
Perché Codex è bloccato nel tuo paese
OpenAI applica il geoblocking su più livelli contemporaneamente. In primo luogo, l'indirizzo IP viene controllato
ad ogni richiesta all'API — se appartiene a un paese della lista non supportata, il server restituirà
un errore 403 Country, region, or territory not supported.
In secondo luogo, durante la registrazione dell'account e l'associazione della carta di pagamento, il sistema confronta la geolocalizzazione dell'IP,
l'indirizzo di fatturazione della carta e il fuso orario del dispositivo — discrepanze aumentano il rischio di blocco dell'account.
In terzo luogo, anche dopo una registrazione riuscita, le sessioni CLI possono interrompersi se l'IP cambia improvvisamente
geolocalizzazione nel mezzo di un compito — questo è tipico per gli IP dinamici degli operatori mobili o
quando si utilizzano VPN gratuite con pool di indirizzi instabili.
Per gli sviluppatori che utilizzano Codex CLI in combinazione con l'automazione — scrittura di codice, revisione di pull request, generazione di test nel pipeline CI — qualsiasi interruzione della connessione significa un compito fallito a metà esecuzione. Pertanto, è importante non solo "bypassare il blocco", ma garantire un IP stabile con la corretta geolocalizzazione per tutto il periodo di lavoro.
Quale tipo di proxy è necessario per Codex CLI
Per lavorare con l'API OpenAI e gli strumenti CLI basati su di essa, sono critici tre parametri: stabilità della sessione (l'IP non deve saltare nel mezzo della richiesta), velocità di risposta e pulizia della reputazione dell'indirizzo (non deve trovarsi nelle liste nere dei servizi di abuso). Esaminiamo le opzioni:
| Tipo di proxy | Per Codex CLI | Stabilità della sessione | Velocità |
|---|---|---|---|
| Proxy residenziali | Sì, scelta principale | Alta (sessioni sticky) | Media-alta |
| Proxy di data center | Adatto per CI/CD e scraping | Molto alta (IP fisso) | Massima |
| Proxy mobili | Eccessivo per compiti API | Media (rotazione operatore) | Media |
Per la maggior parte degli scenari — sviluppo locale, CLI personale, richieste API irregolari — i proxy residenziali con associazione a un IP per sessione (sticky session) sono i più adatti. Forniscono IP reali di fornitori domestici nel paese scelto, riducendo il rischio di essere filtrati dai sistemi di rilevamento degli abusi di OpenAI. Se Codex viene eseguito in un pipeline cloud con un gran numero di compiti paralleli — ad esempio, revisione automatica di decine di repository — è più vantaggioso utilizzare proxy di data center: sono più veloci e più stabili nel mantenere lunghe connessioni senza salti di latenza.
Configurazione del proxy in Codex CLI tramite variabili d'ambiente
Codex CLI, come la maggior parte degli strumenti moderni basati su Node.js e Python, rispetta le variabili d'ambiente standard
HTTP_PROXY
e HTTPS_PROXY.
Questo è il modo più semplice per instradare tutto il traffico CLI attraverso un proxy senza modificare le configurazioni dell'applicazione.
# 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"
# Verifica prima di avviare Codex
curl -x $HTTPS_PROXY https://api.openai.com/v1/models
# Avvio CLI
codex "scrivi un test unitario per la funzione validateEmail"
# Windows PowerShell
$env:HTTP_PROXY = "http://login:password@proxy_host:port"
$env:HTTPS_PROXY = "http://login:password@proxy_host:port"
# Verifica della connessione
Invoke-WebRequest -Uri "https://api.openai.com/v1/models" -Proxy $env:HTTPS_PROXY
codex "rifattorizza questo modulo"
Se il proxy richiede autenticazione con nome utente e password (la maggior parte dei fornitori funziona in questo modo),
specificarli direttamente nell'URL del proxy nel formato
http://user:pass@host:port.
Per i proxy SOCKS5, utilizzare il protocollo socks5://
invece di http:// —
questo è importante, poiché alcuni strumenti CLI distinguono i protocolli e possono ignorare uno schema specificato in modo errato.
Proxy tramite file di configurazione e wrapper Python
Se stai scrivendo i tuoi script attorno all'API OpenAI (ad esempio, elaborazione batch di compiti tramite
openai-python
SDK), le variabili d'ambiente potrebbero non essere sufficienti — a volte è più comodo passare esplicitamente il proxy al client.
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": "Genera una migrazione del database"}]
)
print(response.choices[0].message.content)
Per i wrapper Node.js (se il tuo pipeline Codex è costruito su JS), la logica è simile tramite
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: 'Controlla il codice per vulnerabilità' }],
});
console.log(res.choices[0].message.content);
};
run();
Passare esplicitamente il proxy nel codice è utile quando parte delle richieste nella tua applicazione deve andare direttamente (servizi interni), mentre parte deve passare attraverso il proxy (richieste a OpenAI). In questo modo non rompi la logica di rete rimanente dell'applicazione con variabili d'ambiente globali.
Proxy per compiti cloud: Docker, CI/CD, GitHub Actions
Se Codex viene utilizzato non localmente, ma in un pipeline automatizzato — revisione del codice ad ogni pull request, generazione notturna della documentazione, rifattorizzazione automatica — il proxy deve essere specificato a livello di ambiente di esecuzione del compito, e non solo nel terminale dello sviluppatore.
# 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: Installa Codex
run: npm install -g @openai/codex
- name: Esegui revisione Codex
run: codex review --diff origin/main
Per CI/CD è preferibile un IP statico fisso — questo è proprio uno scenario in cui i proxy di data center si comportano meglio rispetto ai residenziali: la latenza è inferiore, la connessione non si interrompe durante i lavori lunghi, e il costo del traffico per grandi volumi di richieste è sensibilmente inferiore. Assicurati di conservare i segreti del proxy (nome utente, password, host) nei Secrets del repository, e non nel file di workflow stesso.
Rotazione IP e stabilità delle lunghe sessioni
Il principale errore quando si lavora con Codex tramite proxy è l'utilizzo di IP con rotazione automatica per ogni richiesta all'interno di un compito multi-step. L'API OpenAI supporta risposte streaming prolungate e chiamate consecutive all'interno di un unico contesto — se tra queste chiamate cambia l'IP in uscita, il servizio potrebbe considerarlo un'attività sospetta o semplicemente interrompere la connessione streaming.
La soluzione è utilizzare sessioni sticky: il proxy mantiene lo stesso IP assegnato alla tua connessione per un periodo specificato (di solito da 1 a 30 minuti, a seconda delle impostazioni del fornitore), dopo di che lo cambia con uno nuovo. Per Codex CLI è ottimale impostare il tempo di sessione non inferiore alla durata del tuo compito più lungo — se la generazione di un grande PR richiede 5 minuti, la sessione dovrebbe durare almeno 10-15 minuti di margine.
# Esempio di creazione di una sessione sticky tramite parametro nel login del proxy
# (la sintassi dipende dal fornitore, l'opzione tipica è sotto)
export HTTPS_PROXY="http://user-session-abc123:password@proxy_host:port"
Se i compiti vengono eseguiti in parallelo in CI (ad esempio, revisione di 10 pull request contemporaneamente), a ciascun job parallelo dovrebbe essere assegnato un ID di sessione separato — in questo modo eviti di avere più processi che "tirano" lo stesso IP e raggiungono il limite di rate API prima del previsto.
Errori comuni e come risolverli
Esaminiamo i problemi tipici che gli sviluppatori incontrano durante la configurazione del proxy per Codex CLI e API OpenAI.
| Errore | Causa | Soluzione |
|---|---|---|
403 unsupported_country_region_territory |
Il proxy non è stato attivato, la richiesta è stata inviata con l'IP reale | Controlla le variabili d'ambiente tramite curl -x |
| Lo stream si interrompe a metà risposta | L'IP è cambiato nel mezzo della sessione (modalità non sticky) | Attiva la sessione sticky, aumenta il tempo di vita dell'IP |
| Timeout / connessione rifiutata | Porta o protocollo errati (http invece di socks5) | Controlla il protocollo e la porta nella documentazione del fornitore di proxy |
| Il limite di rate si attiva troppo rapidamente | Più processi utilizzano lo stesso IP contemporaneamente | Assegna ID di sessione separati a ciascun processo parallelo |
| L'account ha ricevuto un avviso di attività sospetta | L'IP del data center è finito nel database di abuso | Passa a un IP residenziale con una reputazione pulita |
Checklist prima dell'avvio
Prima di affidare a Codex CLI un compito di produzione tramite proxy, segui questa breve lista:
- Verifica la disponibilità di
api.openai.comtramitecurl -xcon il tuo proxy - La geolocalizzazione del proxy corrisponde al paese indicato nella fatturazione dell'account OpenAI
- La sessione sticky è attivata con un tempo di vita maggiore della durata del compito più lungo
- Per CI/CD, i segreti del proxy sono stati spostati nei Secrets e non sono memorizzati nel codice del workflow
- Per compiti paralleli vengono utilizzati diversi ID di sessione, non un solo IP condiviso
- I log CLI sono stati controllati per richieste dirette nascoste che bypassano il proxy (ad esempio, da dipendenze esterne)
Conclusione
Lavorare con OpenAI Codex CLI da un paese senza supporto ufficiale richiede non solo un bypass occasionale del blocco, ma una configurazione sistematica della rete: il tipo di proxy corretto, sessioni sticky per richieste lunghe e un'integrazione accurata nelle variabili d'ambiente o nel codice del client. Per lo sviluppo locale e compiti irregolari sono più adatti gli IP residenziali con una reputazione pulita, mentre per i pipeline CI/CD ad alta intensità sono più indicati i proxy di data center veloci e stabili.
Se prevedi di eseguire Codex e altri strumenti basati su OpenAI API da una regione senza supporto ufficiale, ti consigliamo di iniziare con proxy residenziali per un funzionamento stabile della CLI, e per compiti automatizzati su larga scala nel cloud — con proxy di data center, che garantiranno bassa latenza e costi prevedibili per grandi volumi di richieste all'API.