"Unexpected status 404 Not Found" no Codex: as 3 causas e como resolver

O Codex parou de responder e devolveu unexpected status 404 Not Found. Antes de reinstalar qualquer coisa, leia o que vem depois do 404: em setembro de 2026 essa mesma linha apareceu com três causas diferentes no repositório oficial openai/codex, e cada uma tem uma saída própria.

Qual das três versões do 404 você recebeu?

O texto depois de 404 Not Found: diz a causa. Compare com a tabela e vá direto para a seção certa.

Trecho da mensagem	Causa	O que fazer
Unknown error, url: https://chatgpt.com/backend-api/codex/responses	Falha no backend da OpenAI	Conferir status.openai.com e esperar
The model `gpt-5.5` does not exist or you do not have access to it	Modelo fora do catálogo da sua conta ou do seu cliente	Trocar de modelo com /model ou -m
url: https://chatgpt.com/backend-api/codex/responses/compact	Flag remote_compaction_v2 = false no config.toml	Apagar a linha e reabrir o Codex

"404 Not Found: Unknown error": o problema é seu?

Não. Quando a mensagem traz Unknown error e a URL termina em /codex/responses, a falha está no backend da OpenAI, e nada que você mude na máquina resolve.

Foi o que aconteceu em 3 de setembro de 2026. A issue #42534 juntou mais de 30 relatos em minutos, de Windows, macOS e Linux, passando por bordas da Cloudflare em regiões diferentes (VNO, NRT, SIN, MIA). Um dos relatos mostrou que até a lista de modelos falhava:

failed to refresh available models: unexpected status 404 Not Found: Unknown error,
url: https://chatgpt.com/backend-api/codex/models?client_version=0.149.1

A OpenAI registrou o incidente como "Elevated errors across ChatGPT and Codex", com Codex Web, Codex API, CLI e extensão do VS Code afetados, e marcou como resolvido no mesmo dia (status.openai.com).

O que fazer:

1. Abra status.openai.com. Se houver incidente aberto para Codex, pare por aí.
2. Não adianta criar conversa nova nem trocar de modelo: quem testou isso na #42534 continuou recebendo o mesmo 404.
3. Não reinstale nem atualize às pressas. Um relato na mesma issue subiu o CLI de 0.152.1 para 0.153.0 e o erro seguiu igual, porque o problema não estava no cliente.

"The model does not exist or you do not have access to it": como trocar de modelo?

Esse 404 significa que o modelo configurado não está disponível para a sua conta naquele cliente. Trocar para um modelo listado resolve na hora; esperar o catálogo ser atualizado resolve de vez.

Dois casos reais em setembro de 2026:

• gpt-5.5 (issues #44477 e #43415, a partir de 7/09): o modelo seguia acessível no app do ChatGPT, mas a rota do Codex devolvia 404. No mesmo ambiente, gpt-5.6-sol funcionava.
• gpt-6-sol (issue #47412, 23/09): no Windows, o Codex Desktop usava um CLI embutido (0.153.4) cujo catálogo não trazia gpt-6-sol nem gpt-6-luna, enquanto o CLI avulso 0.156.1 trazia os dois.

O que fazer: dentro da sessão, abra o seletor e escolha um modelo da lista:

/model

Pelo terminal, force o modelo na hora de abrir (a flag -m, ou --model, está em codex-rs/utils/cli/src/shared_options.rs):

codex -m gpt-5.6-sol

Para deixar fixo, ajuste o ~/.codex/config.toml:

model = "gpt-5.6-sol"

Quer saber quais modelos o seu binário conhece antes de escolher? O subcomando de depuração imprime o catálogo em JSON:

codex debug models            # catálogo atualizado do servidor
codex debug models --bundled  # só o catálogo embutido no binário

Se o modelo aparece na web e não aparece aqui, o problema é o cliente, como no caso do Desktop no Windows. Use o CLI avulso mais novo até sair um build do Desktop com o catálogo atualizado.

URL terminando em "/responses/compact": por que a conversa morre?

Se o 404 aparece logo depois de "Context automatically compacted" e a URL termina em /codex/responses/compact, a culpa é de uma flag antiga no seu config.toml. Apague a linha e a compactação volta.

A issue #42468 (3/09/2026) documenta o caso: no Codex Desktop 26.901 com core 0.153.0, quem tinha isto no arquivo

[features]
remote_compaction_v2 = false

passava a mandar a compactação para um endpoint aposentado. O pior é o efeito em cascata: a conversa continua acima do limite de compactação, então todo turno seguinte tenta compactar de novo e falha igual. A thread fica inutilizável.

O que fazer:

1. Veja o estado das flags no seu binário:

   codex features list

2. Abra ~/.codex/config.toml e apague a linha remote_compaction_v2 = false. Segundo a própria issue, trocar para true ou remover a linha devolve a compactação.
3. Atualize. No código atual do openai/codex essa flag está marcada como Stage::Removed em codex-rs/features/src/lib.rs, ou seja, não existe mais como opção.

Nenhuma das três? Como diagnosticar o resto?

Rode o diagnóstico local. O codex doctor checa instalação, configuração, login, rede e o handshake com o backend, sem tentar consertar nada:

codex doctor            # relatório completo
codex doctor --summary  # só o resumo por grupo
codex doctor --json     # versão redigida, para anexar em issue

No incidente de 3/09, um usuário mostrou na #42534 como o 404 aparece no relatório quando rede, TLS e login estão todos certos:

handshake transport error http 404 Not Found
ChatGPT inference URL: ... reachable (HTTP 404)

Rede e TLS verdes com handshake em 404 apontam para o lado da OpenAI, e você volta para a primeira seção. Se o doctor acusar proxy, certificado ou login, o problema é local e o relatório já diz qual.

Ao abrir issue, inclua o cf-ray e o request id que vêm no fim da mensagem de erro. Foi com eles que os relatos da #42534 conseguiram provar que era falha de backend e não de uma máquina só.