A OpenAI não suporta oficialmente dezenas de países — incluindo Rússia, Bielorrússia, Irã e várias outras regiões.
Ao tentar executar codex
a partir de tais locais, você receberá um bloqueio geográfico direto, ou a recusa na emissão da chave API,
ou uma conexão instável com desconexões constantes ao executar tarefas em nuvem. Isso pode ser resolvido
com um proxy configurado corretamente — mas aqui os detalhes são importantes: nem todo tipo de proxy
é adequado para ferramentas CLI e processos de fundo prolongados.
Por que o Codex é bloqueado em seu país
A OpenAI aplica bloqueio geográfico em vários níveis ao mesmo tempo. Primeiro, o endereço IP é verificado
a cada solicitação à API — se ele pertencer a um país da lista de não suportados, o servidor retornará
o erro 403 Country, region, or territory not supported.
Em segundo lugar, ao registrar uma conta e vincular um cartão de crédito, o sistema verifica a geolocalização do IP,
o endereço de cobrança do cartão e o fuso horário do dispositivo — discrepâncias aumentam o risco de bloqueio da conta.
Em terceiro lugar, mesmo após um registro bem-sucedido, as sessões CLI podem ser interrompidas se o IP mudar
repentinamente de geolocalização no meio de uma tarefa — isso é típico para IPs dinâmicos de operadoras móveis ou
ao usar VPNs gratuitas com um pool de endereços instável.
Para desenvolvedores que usam Codex CLI em conjunto com automação — escrevendo código, revisando pull requests, gerando testes em um pipeline CI — qualquer desconexão significa que a tarefa falhou no meio da execução. Portanto, é importante não apenas "contornar o bloqueio", mas garantir um IP estável com a geolocalização correta durante todo o período de trabalho.
Qual tipo de proxy é necessário para Codex CLI
Para trabalhar com a API da OpenAI e ferramentas CLI baseadas nela, três parâmetros são críticos: estabilidade da sessão (o IP não deve mudar no meio da solicitação), velocidade de resposta e reputação do endereço (não estar em listas negras de serviços de abuso). Vamos analisar as opções:
| Tipo de proxy | Para Codex CLI | Estabilidade da sessão | Velocidade |
|---|---|---|---|
| Proxies residenciais | Sim, escolha principal | Alta (sessões sticky) | Média-alta |
| Proxies de data center | Adequado para CI/CD e scraping | Muito alta (IP fixo) | Máxima |
| Proxies móveis | Excessivo para tarefas de API | Média (rotação do operador) | Média |
Para a maioria dos cenários — desenvolvimento local, CLI pessoal, solicitações irregulares à API — os proxies residenciais com um IP fixo por sessão (sessão sticky) são os mais adequados. Eles fornecem IPs reais de provedores domésticos no país escolhido, o que reduz o risco de serem filtrados pelos sistemas de detecção de abuso da OpenAI. Se o Codex for executado em um pipeline em nuvem com um grande número de tarefas paralelas — por exemplo, revisão automática de dezenas de repositórios — é mais vantajoso usar proxies de data center: eles são mais rápidos e estáveis em manter conexões longas sem flutuações de latência.
Configuração de proxy no Codex CLI através de variáveis de ambiente
O Codex CLI, assim como a maioria das ferramentas modernas em Node.js e Python, respeita as variáveis de ambiente padrão
HTTP_PROXY
e HTTPS_PROXY.
Este é o método mais simples para direcionar todo o tráfego CLI através de um proxy sem modificar as configurações do aplicativo.
# Linux / macOS (bash, zsh)
export HTTP_PROXY="http://login:senha@proxy_host:porta"
export HTTPS_PROXY="http://login:senha@proxy_host:porta"
export NO_PROXY="localhost,127.0.0.1"
# Verificação antes de iniciar o Codex
curl -x $HTTPS_PROXY https://api.openai.com/v1/models
# Iniciar CLI
codex "escreva um teste unitário para a função validateEmail"
# Windows PowerShell
$env:HTTP_PROXY = "http://login:senha@proxy_host:porta"
$env:HTTPS_PROXY = "http://login:senha@proxy_host:porta"
# Verificação de conexão
Invoke-WebRequest -Uri "https://api.openai.com/v1/models" -Proxy $env:HTTPS_PROXY
codex "refatore este módulo"
Se o proxy exigir autenticação por login e senha (a maioria dos provedores funciona assim),
especifique-os diretamente na URL do proxy no formato
http://user:pass@host:port.
Para proxies SOCKS5, use o protocolo socks5://
em vez de http:// —
isso é importante, pois algumas ferramentas CLI diferenciam os protocolos e podem ignorar um esquema incorretamente
especificado.
Proxy através de arquivo de configuração e wrappers Python
Se você estiver escrevendo seus próprios scripts em torno da API da OpenAI (por exemplo, processamento em lote de tarefas através
openai-python
SDK), as variáveis de ambiente podem não ser suficientes — às vezes é mais conveniente passar o proxy explicitamente para o cliente.
import httpx
from openai import OpenAI
proxy_url = "http://login:senha@proxy_host:porta"
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": "Gere uma migração de banco de dados"}]
)
print(response.choices[0].message.content)
Para wrappers Node.js (se seu pipeline Codex for construído em JS), a lógica é semelhante através de
https-proxy-agent:
const { HttpsProxyAgent } = require('https-proxy-agent');
const OpenAI = require('openai');
const agent = new HttpsProxyAgent('http://login:senha@proxy_host:porta');
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: 'Verifique o código em busca de vulnerabilidades' }],
});
console.log(res.choices[0].message.content);
};
run();
Passar o proxy explicitamente no código é útil quando parte das solicitações em seu aplicativo deve ir diretamente (serviços internos), enquanto outra parte deve passar pelo proxy (solicitações para OpenAI). Assim, você não quebra a lógica de rede restante do aplicativo com variáveis de ambiente globais.
Proxy para tarefas em nuvem: Docker, CI/CD, GitHub Actions
Se o Codex for usado não localmente, mas em um pipeline automatizado — revisão de código a cada pull request, geração noturna de documentação, refatoração automática — o proxy deve ser configurado no nível do ambiente de execução da tarefa, e não apenas no terminal do desenvolvedor.
# Dockerfile
FROM node:20-slim
ENV HTTP_PROXY="http://login:senha@proxy_host:porta"
ENV HTTPS_PROXY="http://login:senha@proxy_host:porta"
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: Revisão Codex
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: Instalar Codex
run: npm install -g @openai/codex
- name: Executar revisão Codex
run: codex review --diff origin/main
Para CI/CD, um IP fixo e estático é preferível — este é um cenário onde proxies de data center se destacam mais do que os residenciais: a latência é menor, a conexão não é interrompida em longas tarefas, e o custo do tráfego em grandes volumes de solicitações é significativamente menor. Armazene as credenciais do proxy (login, senha, host) nos Secrets do repositório, e não no próprio arquivo de workflow.
Rotação de IP e estabilidade de longas sessões
O principal erro ao trabalhar com Codex através de proxies é usar IPs com rotação automática a cada solicitação dentro de uma única tarefa de múltiplas etapas. A API da OpenAI suporta respostas de streaming longas e chamadas sequenciais dentro de um único contexto — se entre essas chamadas o IP de saída mudar, o serviço pode considerar isso como atividade suspeita ou simplesmente interromper a conexão de streaming.
A solução é usar sessões sticky: o proxy mantém o mesmo IP fixo para sua conexão por um período determinado (geralmente de 1 a 30 minutos, dependendo das configurações do provedor), após o qual ele muda para um novo. Para o Codex CLI, é ideal definir o tempo da sessão para ser pelo menos igual à duração da sua tarefa mais longa — se a geração de um grande PR leva 5 minutos, a sessão deve durar pelo menos 10-15 minutos como margem.
# Exemplo de formação de sessão sticky através de parâmetro no login do proxy
# (a sintaxe depende do provedor, a opção típica é abaixo)
export HTTPS_PROXY="http://user-session-abc123:senha@proxy_host:porta"
Se as tarefas forem executadas em paralelo no CI (por exemplo, revisão de 10 pull requests ao mesmo tempo), cada job paralela deve receber um ID de sessão separado — assim você evita a situação em que vários processos "puxam" o mesmo IP ao mesmo tempo e atingem o limite de taxa da API antes do esperado.
Erros comuns e como corrigi-los
Vamos analisar problemas típicos que os desenvolvedores enfrentam ao configurar proxies para Codex CLI e API da OpenAI.
| Erro | Causa | Solução |
|---|---|---|
403 unsupported_country_region_territory |
O proxy não foi utilizado, a solicitação foi enviada com o IP real | Verifique as variáveis de ambiente através de curl -x |
| O stream é interrompido no meio da resposta | O IP mudou no meio da sessão (sem modo sticky) | Ativar sessão sticky, aumentar o tempo de vida do IP |
| Timeout / conexão recusada | Porta ou protocolo incorretos (http em vez de socks5) | Verifique o protocolo e a porta na documentação do provedor de proxy |
| O limite de taxa é atingido muito rapidamente | Vários processos usam o mesmo IP ao mesmo tempo | Atribuir IDs de sessão separados para cada processo paralelo |
| A conta recebeu um aviso de atividade suspeita | O IP do data center foi listado em uma base de abuso | Mudar para um IP residencial com boa reputação |
Checklist antes de iniciar
Antes de confiar ao Codex CLI uma tarefa em produção através de um proxy, passe por uma lista curta:
- Verificou a acessibilidade de
api.openai.comatravés decurl -xcom seu proxy - A geolocalização do proxy coincide com o país indicado na cobrança da conta OpenAI
- A sessão sticky está ativada com um tempo de vida maior do que a duração da tarefa mais longa
- Para CI/CD, as credenciais do proxy estão armazenadas nos Secrets, e não no código do workflow
- Para tarefas paralelas, IDs de sessão diferentes estão sendo usados, e não um IP comum
- Os logs do CLI foram verificados quanto a solicitações diretas ocultas que contornam o proxy (por exemplo, de dependências externas)
Conclusão
Trabalhar com OpenAI Codex CLI de um país sem suporte oficial requer não apenas uma solução pontual para contornar o bloqueio, mas uma configuração sistemática da rede: o tipo correto de proxy, sessões sticky para solicitações longas e uma integração cuidadosa nas variáveis de ambiente ou no código do cliente. Para desenvolvimento local e tarefas irregulares, os IPs residenciais com boa reputação são mais adequados, enquanto para pipelines CI/CD pesados — proxies de data center rápidos e estáveis.
Se você planeja executar o Codex e outras ferramentas baseadas na API da OpenAI de uma região sem suporte oficial, recomendamos começar com proxies residenciais para um funcionamento estável do CLI, e para tarefas automatizadas em larga escala na nuvem — com proxies de data center, que garantirão baixa latência e custos previsíveis em grandes volumes de solicitações à API.