Codex não responde ou travou? Como descobrir se o problema é a OpenAI, sua conta ou o seu ambiente

Fala aí, beleza? Quando o Codex não responde, a primeira pergunta não é "o que eu quebrei?", e sim: de quem é a falha?

São três suspeitos: o serviço da OpenAI, a sua conta (login ou limite do plano) ou o seu ambiente local (versão da CLI, rede, proxy, sandbox, permissões)

Esse guia é pra quem usa o Codex na CLI, na extensão de IDE ou na nuvem e viu o agente parar no meio, ficar mudo ou falhar na autenticação

A ordem de checagem é sempre a mesma: status oficial primeiro, depois conta e plano, depois a sua máquina 🙂

Se você ainda está entendendo o que é o Codex e como ele se divide entre CLI, IDE e nuvem, vale dar uma olhada antes

O problema é a OpenAI? Como checar o status oficial do Codex

Se tudo falha ao mesmo tempo (CLI, extensão e nuvem dando erro juntos), o mais provável é incidente no serviço, não no seu PC

Abra a página de status da OpenAI e procure o componente Codex

Ele tem incidentes próprios, separados dos demais serviços, publicados com títulos como "Issues with Codex" e "Degraded performance in Codex and ChatGPT Work"

Um exemplo recente: em 14/10/2026 a OpenAI identificou erros elevados no Codex e no ChatGPT Work às 3h05 (horário do Leste dos EUA), aplicou uma mitigação e registrou recuperação total às 5h53 do mesmo dia

O incidente foi marcado como resolvido

O componente Codex pode ter subdivisões por superfície, então abra ele e veja se a parte que você usa aparece afetada

Como prevenir: consulte o status ANTES de mexer em qualquer configuração local

Nada pior que sair rodando os rm -rf da vida na sua pasta de config por causa de um incidente que a OpenAI já estava resolvendo haha

Codex parou no meio da tarefa: pode ser limite de uso do plano

Se o status está normal e o agente para ou recusa novas tarefas, desconfie do limite de uso

O Codex está incluído nos planos do ChatGPT, do Free e do Go até o Enterprise, mas cada plano tem limites próprios

E esses limites não são fixos por mensagem: dependem do modelo, de onde a tarefa roda, da complexidade, do contexto, do raciocínio, da velocidade e das ferramentas usadas

Se liga nisso: tarefas na nuvem podem consumir MAIS da cota que mensagens locais (fonte oficial)

Como ver quanto de limite sobrou:

Numa sessão ativa da CLI, rode:

/status

Ele mostra os limites de uso restantes, que também aparecem no painel de uso da conta

E os resets salvos na conta?

Existem resets "banked", que ficam guardados na conta até serem usados ou expirarem

Você aplica em settings > usage, no app desktop, na CLI ou na web, pela opção "1 reset available" ou "Full reset"

Erro comum: abrir chamado no suporte pedindo pra zerar a cota

O suporte da OpenAI não reseta limites do ChatGPT nem do Codex: ou você espera o reset, ou usa outra opção mostrada na própria conta

Como prevenir: com a cota baixa, prefira tarefas locais e prompts mais focados, com menos contexto jogado de uma vez

Falha de login ou autenticação no Codex: conta, navegador e proxy

Serviço no ar, cota sobrando e mesmo assim nada funciona? Hora de olhar o login

Navegador não abre no login:

Acontece muito em servidor remoto, SSH ou container sem interface gráfica

A CLI aceita autenticação por código de dispositivo:

codex login --device-auth

Ela mostra uma URL e um código, e você digita esse código em auth.openai.com/activate de qualquer navegador (documentação de autenticação)

Extensão de IDE: ChatGPT ou API Key?

A extensão aceita dois métodos: Sign in with ChatGPT (acesso pela assinatura) ou chave de API (cobrança por uso)

Pra entrar com a chave, escolha Use API Key na tela deslogada

Detalhe importante: a CLI e a extensão guardam os dados de login em cache e compartilham esse MESMO cache

Ou seja, se o login está zoado em um, a chance de estar zoado no outro é grande, e vice-versa

Rede corporativa com proxy ou CA privada:

Que CA privada? É quando a empresa intercepta o tráfego HTTPS com um certificado raiz próprio, e aí o Codex não confia na conexão

Nesse caso, defina CODEX_CA_CERTIFICATE apontando para um bundle PEM ANTES do login:

export CODEX_CA_CERTIFICATE=/caminho/ca.pem
codex login

Sem essa variável, o Codex usa SSL_CERT_FILE

E a mesma configuração vale para o login, para as requisições HTTPS e para as conexões WebSocket seguras

O raciocínio é parecido com o de um erro de conexão no Cursor: antes de culpar a ferramenta, descarte rede, VPN e proxy

Codex Cloud não aparece pra sua conta?

Pode não ser bug: o Codex Cloud está disponível para contas elegíveis Plus, todos os níveis Pro, Business, Enterprise, Healthcare e Education, sujeito ao rollout e às configurações do workspace

Como prevenir: em rede corporativa, configure a CA antes do primeiro login, não depois do primeiro erro 😛

Codex travado na CLI: versão, sandbox, aprovação e rede

Com serviço, cota e login ok, o suspeito agora é o ambiente local

Confira e atualize a versão:

codex --version

# atualizar via npm
npm update -g @openai/codex

# ou via Homebrew
brew upgrade --cask codex

# ou, quando a build tem autoatualização
codex update

Os comandos de instalação e atualização estão no repositório oficial openai/codex

Rode o codex doctor:

Esse é o comando que mais economiza tempo:

codex doctor --summary

Ele gera um relatório de diagnóstico da instalação local, configuração, autenticação, runtime, Git, terminal, app-server e inventário de threads

As flags disponíveis são --all, --ascii, --json, --no-color e --summary (referência da CLI)

Sandbox e aprovação: o falso travamento

Que sandbox? É o limite do que o agente pode fazer na sua máquina, tipo deixar o estagiário mexer só na pasta do projeto

O Codex tem três modos:

• read-only: só leitura
• workspace-write: o padrão de baixa fricção para trabalho local
• danger-full-access: acesso total (o nome já avisa, né?)

Por padrão, não há acesso à rede e a escrita fica restrita ao workspace ativo

Agora o pulo do gato: no preset Auto, que equivale a estas flags…

codex --sandbox workspace-write --ask-for-approval on-request

…o Codex pede aprovação para editar fora do workspace ou para rodar comandos que precisam de rede

Erro comum: achar que o agente travou quando, na real, ele está parado esperando você aprovar algo

Se a tarefa precisa de rede de saída dentro do workspace-write, a configuração sandbox_workspace_write.network_access libera isso (segurança e aprovações)

Como prevenir: escolha o modo de sandbox e a política de aprovação de acordo com a tarefa, em vez de descobrir no meio dela

Extensão do Codex no VS Code não aparece ou não responde

Extensão instalada, mas sumida da interface:

Abra a Command Palette e rode:

Codex: Open Codex Sidebar

Windows: instalada, mas sem resposta

No Windows, podem estar faltando ferramentas de C++

Instale o Visual Studio Build Tools (workload C++) e o Microsoft Visual C++ Redistributable (x64), e depois reinicie o VS Code POR COMPLETO, não só a janela (guia do Windows)

Segundo a documentação, a maioria dos problemas no Windows nativo vem da configuração do sandbox, de direitos de logon ou de permissões de arquivos

Confira o login da extensão

Veja se você está logado com ChatGPT ou com API Key, lembrando que o cache é o mesmo da CLI

Às vezes o bug é da própria extensão

Já houve bug conhecido em que mensagens e follow-ups na fila não eram enviados, e o /feedback devolvia "Couldn’t verify feedback permissions. Please try again" (issues #50224 e #50426 no repositório do Codex)

Ou seja, nem todo problema é configuração sua, às vezes o bug já está registrado nos issues

Como prevenir: mantenha a extensão atualizada e dê uma olhada nos issues abertos quando algo estranho aparecer

Tarefa do Codex na nuvem falhou: setup, internet e ambiente não publicado

Pra entender onde quebrou, primeiro o porquê: a tarefa na nuvem roda em etapas

1. O Codex cria um contêiner
2. Faz checkout do repositório na branch ou commit escolhido
3. Roda o setup script, que TEM internet
4. Entra na fase do agente, em que a internet vem desligada por padrão (pode ser liberada de forma limitada ou irrestrita)

É por isso que um npm install que funciona no setup pode falhar quando o agente tenta rodar

O que checar:

• Setup falhou: abra a conversa de setup e veja qual comando falhou
• Download de pacotes falhou: confira se o host está liberado nas configurações de internet do ambiente
• Ambiente com o selo "Unpublished": termine o setup e clique em Publish

E lembre da elegibilidade: o Codex Cloud depende do plano (Plus elegíveis, Pro, Business, Enterprise, Healthcare e Education) e das configurações do workspace (ambientes de nuvem)

Como prevenir: coloque a instalação de dependências no setup script, que é a fase com internet

Chat do app Codex travado: o que fazer antes de recomeçar

A documentação do app recomenda três passos, nessa ordem:

1. Verificar se o chat está esperando uma aprovação sua
2. Rodar um comando simples como git status no terminal, pra conferir o estado dos arquivos
3. Abrir um chat novo com um prompt menor e mais focado

O passo 2 é o que salva: antes de jogar o chat fora, você sabe exatamente o que já mudou no projeto (troubleshooting do app)

Como prevenir: divida tarefas grandes em prompts menores, o agente se perde MUITO menos

Como retomar a tarefa no Codex sem perder o trabalho

O objetivo aqui é voltar de onde parou, com o histórico da conversa e sem refazer o que já estava pronto

Requisito: ter a CLI instalada e estar no diretório do projeto

1. Veja o que já foi alterado:

git status

Assim você sabe se o agente chegou a mexer em arquivos antes de travar

2. Retome a sessão com codex resume:

# abre o seletor de sessões
codex resume

# retoma a sessão mais recente do diretório atual
codex resume --last

# inclui sessões de outros diretórios
codex resume --all

Também dá pra passar um SESSION_ID ou um prompt de continuação, e dentro do Codex o /resume faz o mesmo

O erro comum deste passo: rodar codex resume --last em outro diretório e não achar a sessão, porque ele olha só o diretório atual

Nesse caso, use --all ou volte para a pasta do projeto

3. Se precisar consultar o histórico na mão, as transcrições ficam em $CODEX_HOME/sessions (padrão ~/.codex/sessions) e as arquivadas em ~/.codex/archived_sessions

Checagem final: a conversa retomada precisa ser a da tarefa que travou, e o git status precisa bater com o que o agente diz ter feito

Quando abrir um issue no GitHub do Codex ou falar com o suporte

Se o bug é reproduzível (você repete os passos e ele acontece de novo), o lugar é o GitHub do Codex

Informe o componente usado (CLI, SDK, extensão de IDE, Codex cloud ou Codex Security) e, quando possível, a versão

O repositório tem templates prontos de bug report e de CLI, então use eles em vez de escrever do zero

O que anexar:

• Saída do codex doctor: ele entrou no repositório pelo PR #22336 justamente pra dar contexto a usuários e ao suporte
• Logs do app no macOS: ficam em ~/Library/Logs/com.openai.codex/AAAA/MM/DD

Tome cuidado! A documentação pede pra revisar os logs antes de compartilhar, pra não expor dados sensíveis

E o que dá pra investigar sozinho?

CLI, Codex SDK e app server são open source, sob licença Apache-2.0, então dá pra ler o código e os issues dessas partes

A extensão de IDE não é open source

E limite de uso não é caso de suporte, já que o suporte não reseta cotas

Como prevenir: ao notar o erro, anote a versão (codex --version) e os passos que levaram até ele, antes que você esqueça

Quer conhecer o Codex Security, a ferramenta da OpenAI voltada a encontrar vulnerabilidades no código? Se liga nesse vídeo do canal Hora de Codar:

Próximo passo: deixe o diagnóstico pronto antes da próxima falha

O melhor momento pra preparar o diagnóstico é agora, com tudo funcionando

• Favorite o status.openai.com, pra ser a primeira aba que você abre quando algo parar
• Rode codex doctor --summary hoje e guarde a saída: na próxima falha você compara com algo que funcionava
• Se estiver em rede corporativa, configure o CODEX_CA_CERTIFICATE agora, antes do próximo login

Com isso, a próxima vez que o agente parar vira questão de minutos, não de uma tarde inteira reinstalando coisa 😀

até o próximo post!

Quer aprender mais sobre inteligência artificial e programação na prática? Conheça o canal Hora de Codar no YouTube e acompanhe os próximos vídeos.