← Voltar ao blog

Como configurar um proxy para OpenAI Codex CLI em países sem suporte ao OpenAI: guia completo

Guia passo a passo para configurar um proxy para OpenAI Codex CLI e API em regiões sem suporte da OpenAI — com exemplos de configuração e análise de erros comuns.

📅22 de novembro de 2026

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.com através de curl -x com 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.