Se você abrir o cliente Codex, o Codex CLI ou a versão desktop do ChatGPT para fazer login e se deparar com uma janela com fundo branco e letras pretas exibindo o logotipo da OpenAI e a mensagem "Ops, algo deu errado! Erro durante a verificação (unknown_country). Tente novamente.", é muito provável que você esteja caindo na mesma armadilha: o fato de a versão web do ChatGPT funcionar normalmente não significa que o IP da sua rede no momento do login no cliente seja aceito pela OpenAI. Esse ponto, que desafia o senso comum, é a raiz do erro unknown_country que a maioria das pessoas não consegue resolver, mesmo após passar a noite toda tentando, limpando cache ou trocando de conta.
O código oficial desse erro, na verdade, não é unknown_country, mas sim unsupported_country_region_territory. Existem inúmeros registros sobre isso no GitHub Issues e na comunidade de desenvolvedores da OpenAI, e todos os pontos de gatilho estão concentrados na etapa de 403 Forbidden em https://auth.openai.com/oauth/token. A seguir, explicarei o porquê disso acontecer, apresentarei uma solução de proxy global + seleção de região de IP que você pode verificar imediatamente e, por fim, recomendarei dois serviços tradicionais para resolver suas necessidades de upgrade de assinatura e recarga de chave API após o login.
Por que o erro unknown_country ocorre: o mecanismo de verificação em duas etapas do cliente Codex
Para entender esse erro, é preciso ver claramente o que o login do cliente Codex realmente faz. Não se trata de uma simples solicitação de rede, mas de um fluxo padrão de autorização OAuth 2.0, que na verdade é dividido em duas solicitações independentes, cada uma seguindo caminhos de rede diferentes. A primeira etapa é o redirecionamento do navegador para auth.openai.com para concluir a autorização da conta; a segunda etapa é o cliente recuperar o código de autorização e trocá-lo pelo access token real em https://auth.openai.com/oauth/token. O problema ocorre na segunda etapa, não na primeira.
| Etapa | Onde ocorre | O que é verificado | Ponto de falha |
|---|---|---|---|
| 1ª Etapa: Autorização | Navegador padrão | Conta/senha / 2FA | Geralmente bem-sucedido |
| 2ª Etapa: Troca de Token | Fetch do processo do cliente | IP do cliente na zona suportada | Gatilho do unknown_country |
| Callback | Local 127.0.0.1 | Análise de parâmetros da URL | Geralmente normal |
O problema crucial é que a primeira solicitação de autorização é feita pelo navegador, que utiliza o proxy do sistema, por isso a versão web do ChatGPT abre normalmente. No entanto, a segunda solicitação de troca de Token é feita pelo próprio processo do cliente Codex. De acordo com testes em várias issues do GitHub (openai/codex#14215, openai/codex#6849), o Codex, em algumas versões, não herda rigorosamente variáveis de ambiente como HTTPS_PROXY, utilizando diretamente a saída de rede padrão do sistema. Como o IP de saída da rede na China continental não está na lista de países/regiões suportados pela OpenAI, o sistema retorna um 403 unsupported_country_region_territory, que acaba sendo exibido na janela do cliente como "Erro durante a verificação (unknown_country)".
É por isso que muitos usuários caem no ciclo vicioso de "a web funciona, mas o cliente não loga". A web usa o proxy do navegador, enquanto o cliente usa a saída do sistema; é muito provável que sejam dois caminhos completamente diferentes. A maneira mais simples de verificar isso é abrir o navegador e acessar ipinfo.io ou ip.sb no momento em que o cliente apresentar o erro. Se o país exibido não for Singapura, Taiwan, Estados Unidos, Japão ou outra região suportada pela OpenAI, então essa é a causa, sem dúvida.
Guia prático: Solucionando o erro "unknown_country" no Codex com proxy global
O segredo para corrigir esse erro é simples: garantir que as solicitações feitas pelo processo do cliente passem por um proxy localizado em uma região suportada. A maneira mais segura de fazer isso é ativar o "Proxy Global" (modo Global ou TUN), forçando todos os processos a utilizarem o proxy, em vez de apenas o navegador. A tabela abaixo resume os caminhos de configuração no macOS e Windows.
| Sistema Operacional | Método Recomendado | Configurações Principais | Método de Verificação |
|---|---|---|---|
| macOS | Modo TUN ou Proxy Global | Cliente de proxy → Modo Global / TUN | curl ipinfo.io mostra IP de região suportada |
| Windows | Modo TUN (adaptador virtual) | Cliente de proxy → TUN | ipconfig + ipinfo.io (dupla checagem) |
| Geral | Variáveis de ambiente (opcional) | export HTTPS_PROXY e HTTP_PROXY | Verificação via comando env |
Recomendamos seguir estes passos nesta ordem: primeiro, alterne o modo do seu cliente de proxy de "Modo de Regras" ou "PAC" para "Modo Global" ou ative o TUN. Em seguida, selecione um nó de saída em Singapura, Taiwan, Estados Unidos ou Japão — todas essas regiões estão na lista oficial de suporte da OpenAI. Terceiro, encerre completamente o processo do cliente Codex (no macOS use ⌘+Q, no Windows use o Gerenciador de Tarefas), não apenas feche a janela. Por fim, reinicie o cliente Codex e tente fazer login novamente; a troca do OAuth Token passará pelo proxy e o erro "unknown_country" desaparecerá.
Se você estiver usando o Codex CLI em vez do cliente gráfico, também pode definir as seguintes variáveis de ambiente no seu shell antes de iniciar o login, já que algumas versões da CLI leem esses valores:
export HTTPS_PROXY="http://127.0.0.1:7890"
export HTTP_PROXY="http://127.0.0.1:7890"
export NO_PROXY="localhost,127.0.0.1"
codex login
Vale ressaltar que o comportamento das variáveis de ambiente pode variar entre diferentes versões do Codex. A documentação oficial da OpenAI sugere usar o login via device code caso encontre anomalias no fluxo OAuth: execute codex login --device-auth. Você receberá um código único e uma URL; basta colar o código em qualquer dispositivo que tenha acesso à OpenAI para concluir a verificação. Esse método contorna a etapa de troca de token pelo processo do cliente, sendo a forma mais eficaz em ambientes de rede complexos.
🎯 Lista de verificação rápida: Ative o proxy global → Acesse ipinfo.io no navegador para confirmar que o IP não está na China continental → Encerre completamente o cliente Codex → Reinicie → Tente fazer login novamente. Esse método de quatro etapas resolve mais de 90% dos erros "unknown_country" no Codex.
Estratégia de seleção de região de IP para o erro "unknown_country" no Codex
A lista oficial de países suportados pela OpenAI cobre mais de 100 regiões, mas a China continental, Hong Kong, Rússia, Irã e outras áreas não estão incluídas. Para usuários na China, as quatro opções mais viáveis são: Singapura, Taiwan, Estados Unidos e Japão. O gráfico comparativo abaixo mostra as regiões candidatas, focando principalmente em latência, estabilidade e capacidade dos nós.
| Região IP | Suporte OpenAI | Latência Medida | Capacidade do Nó | Cenário Recomendado |
|---|---|---|---|---|
| Singapura | ✅ Suportado | Baixa | Alta | Escolha diária, latência estável |
| Taiwan | ✅ Suportado | Mínima | Média | Distância física mais curta |
| EUA | ✅ Suportado | Alta | Altíssima | Recursos do modelo disponíveis primeiro |
| Japão | ✅ Suportado | Baixa | Média | Alternativa estável |
| Hong Kong | ❌ Não suportado | Mínima | Alta | ⚠ Não use, causará erro novamente |
O erro mais comum na prática é o uso indevido de nós de Hong Kong. Devido à proximidade física e baixa latência, muitos clientes de proxy recomendam Hong Kong por padrão, mas como a OpenAI não suporta essa região, o uso disparará o erro unknown_country. Uma forma simples de verificar é acessar chat.openai.com pelo navegador; se aparecer "Access denied" ou um aviso de bloqueio, significa que o IP de saída não é suportado e você precisa trocar de nó.
| Princípio de Seleção | Prioridade | Explicação |
|---|---|---|
| Está na lista da OpenAI | Obrigatório | Se não estiver, falhará |
| Estabilidade do nó | Alta | Afeta a estabilidade da conversa |
| Latência | Média | Afeta a velocidade, mas não o login |
| Capacidade do nó | Média | Afeta o desempenho em horários de pico |
Se o seu cliente de proxy alterna nós com frequência, recomendamos fixar um nó de Singapura ou Taiwan para o tráfego da OpenAI nas configurações, deixando o restante do tráfego sob regras de correspondência. Isso garante um login estável no Codex e evita que serviços locais ou vídeos sejam lentificados pelo proxy.
Solução após o login no Codex: Recomendações para assinatura do ChatGPT e recarga de API
Muitos usuários, após resolverem o erro unknown_country no Codex, deparam-se com outro problema: embora o cliente permita o login, o acesso aos recursos completos (Codex Cloud, cotas do ChatGPT Plus/Pro, modelos Pro) exige uma assinatura paga. O ChatGPT aceita apenas cartões de crédito internacionais ou PayPal, bloqueando métodos de pagamento comuns na China. Da mesma forma, se você deseja usar a API da OpenAI para negócios, a recarga de saldo também exige um cartão internacional.
Para essas necessidades, existem serviços de intermediação com boa reputação que se mantêm funcionais apesar das constantes mudanças nas políticas da OpenAI:
| Site de Serviço | Cenário Principal | Público-alvo |
|---|---|---|
| Site de upgrade: ai.daishengji.com | Upgrade para ChatGPT Plus / Pro / Team / Edu | Pessoas/equipes sem cartão internacional |
| Recarga GPT: www.gpt516.com | Recarga de saldo API OpenAI / Assinatura ChatGPT | Desenvolvedores que precisam de API estável |
| APIYI apiyi.com | API multimodal unificada | Desenvolvedores que precisam apenas de GPT-5.5 / Claude / Gemini |
🎯 Dica de Upgrade: Se o seu objetivo é usar cotas Plus/Pro em clientes oficiais como ChatGPT, Codex ou Sora, priorize o site
ai.daishengji.com, que possui processos padronizados. Se precisa de saldo na API oficial da OpenAI, owww.gpt516.comé uma opção com longo tempo de operação e suporte estável.
🎯 Rota Alternativa: Se você apenas deseja invocar modelos da série OpenAI em suas próprias aplicações, não precisa de uma assinatura do ChatGPT. Você pode usar a plataforma APIYI (apiyi.com) para realizar chamadas de modelos como GPT-5.5, Claude 4.7 Opus e Gemini 3.1 Pro pagando em moeda local, contornando totalmente as barreiras de pagamento da OpenAI. É o caminho mais simples para desenvolvedores.
FAQ: Problemas comuns de login no Codex com erro unknown_country
P1: Já ativei o proxy, por que ainda recebo o erro unknown_country?
Existem três motivos comuns: primeiro, o proxy está no "modo de regras" em vez do "modo global / TUN", fazendo com que a solicitação do Token OAuth do processo do cliente Codex não passe pelo proxy. Segundo, você selecionou um nó de Hong Kong, que não está na área de suporte da OpenAI. Terceiro, o processo do cliente Codex não foi totalmente encerrado e reiniciado, mantendo as configurações de rede antigas. Recomendo seguir o método de quatro etapas na segunda seção deste artigo para verificar cada item.
P2: Posso não usar o proxy global e fazer apenas o Codex passar pelo proxy?
Pode, mas o procedimento varia conforme o tipo de cliente. O Codex CLI pode ser iniciado após exportar HTTPS_PROXY e HTTP_PROXY, e algumas versões conseguem reconhecer isso. Para o cliente gráfico do Codex, recomendo usar o proxy global diretamente, pois o suporte a variáveis de ambiente varia entre as versões do cliente; o proxy global é a abordagem mais segura.
P3: Por que o ChatGPT no navegador funciona, mas o cliente Codex não consegue logar?
Porque o navegador utiliza o proxy do sistema ou as configurações de proxy integradas, enquanto o processo do cliente Codex, em algumas versões, não herda automaticamente as mesmas configurações de proxy. Esta é a armadilha clássica dos "dois canais de rede", explicada detalhadamente na primeira seção deste artigo.
P4: Se eu realmente não conseguir resolver os problemas de rede, existe uma alternativa mais fácil?
Existem dois caminhos. O primeiro é pagar por um site de atualização de IA: ai.daishengji.com para concluir a atualização para o ChatGPT Plus ou Pro e continuar usando produtos oficiais como o cliente Codex. O segundo é contornar o cliente oficial e usar a plataforma APIYI (apiyi.com) para realizar a invocação do modelo da série OpenAI, sem precisar de uma conta ChatGPT ou de um proxy global.
P5: Como usar o método de login por device code?
Para o Codex CLI, execute codex login --device-auth para obter um código único e uma URL. Cole o código em qualquer dispositivo que já tenha acesso à OpenAI (como o computador de um amigo no exterior) para concluir a verificação. Sua máquina local não precisa de conexão direta com a OpenAI, o que garante a maior taxa de sucesso em ambientes de rede complexos. Esta é a solução de contingência recomendada oficialmente pela OpenAI.
P6: Posso usar cartões de crédito nacionais para recarregar o saldo da API da OpenAI?
Não. A recarga da API da OpenAI requer cartões de crédito que suportem liquidação internacional ou PayPal. Se você só possui cartões locais, recomendo usar um site de recarga GPT estabelecido: www.gpt516.com para concluir a recarga, ou usar diretamente a plataforma APIYI (apiyi.com) para pagar em moeda local pela invocação do modelo da OpenAI.
Resumo: Caminho completo para resolver o erro unknown_country no Codex
O erro "Erro durante a verificação (unknown_country)" no cliente Codex não é um problema de conta, mas sim o fato de que o IP de saída da sua rede não é aceito pela OpenAI durante a fase de troca do Token OAuth. A chave para a correção é a combinação de "proxy global + IP de região suportada", em vez de tentar repetidamente ou limpar o cache. Singapura, Taiwan, Estados Unidos e Japão são atualmente as 4 opções de saída mais seguras. Embora Hong Kong tenha a menor latência, ele é listado como uma área não suportada; evite-o a todo custo.
Se após o login você precisar de uma assinatura ChatGPT Plus / Pro ou saldo na API da OpenAI, pode recorrer diretamente a dois serviços estabelecidos: o site de atualização de IA ai.daishengji.com para resolver a assinatura, e o site de recarga GPT www.gpt516.com para resolver a recarga da API. Se o seu objetivo é apenas usar APIs de modelos como GPT-5.5 ou Claude 4.7 Opus, sem precisar de uma assinatura ChatGPT, a APIYI (apiyi.com) é o caminho mais simples para pular todos os problemas de pagamento internacional e proxy.
Equipe técnica da APIYI · Focada em conteúdos práticos sobre APIs de Modelos de Linguagem Grande e ferramentas para desenvolvedores. Para mais artigos técnicos, visite apiyi.com
