Codex Desktop preso na tela branca ou no spinner: como destravar no Windows e no macOS

Você abre o Codex Desktop e ele fica numa tela branca com o spinner girando, ou a janela estava funcionando e de repente virou branca com o logo no meio. Reinstalar quase nunca resolve. Em setembro de 2026 esse sintoma apareceu com três causas diferentes no repositório oficial openai/codex, e em nenhuma delas você perde trabalho: o que trava é a interface, não o agente.

Qual das três telas brancas você tem?

O momento em que a tela fica branca aponta a causa. Compare com a tabela e vá direto para a seção certa.

Quando acontece	Causa provável	O que fazer
Logo ao abrir, depois de atualizar para o build 26.924 no Windows	Falha na inicialização entre a janela e o processo codex.exe (app-server)	Encerrar só o processo filho codex
No meio do uso, depois de um tempo, no Windows ou no macOS	Processo de renderização travado, com 3 GB ou mais de memória	Encerrar só o Codex (Renderer)
Sempre, mesmo depois de reinstalar	~/.codex/config.toml corrompido, cheio de bytes NUL	Renomear o arquivo

Travou no spinner logo depois de atualizar: como destravar no Windows?

Encerre só o processo filho codex enquanto o spinner estiver na tela. O app principal cria outro na hora e a interface carrega com seus projetos e conversas.

O caso está documentado na issue #48333, aberta em 26/09/2026 com o pacote OpenAI.Codex 26.924.1866.0, e confirmado por outros usuários também no build 26.924.2738.0. O log mostra o servidor MCP interno estourando o tempo:

MCP server startup failed server_name="codex_app" error="timed out awaiting tools/list after 10s"

Quem abriu a issue já tinha tentado Reparar e Redefinir no Windows, desinstalar e reinstalar, um .codex novo e remover o config.toml. Nada disso resolveu, então pule essas etapas.

O que fazer:

1. Com o spinner na tela, abra o Gerenciador de Tarefas, expanda o grupo do app e finalize o processo filho chamado Codex (relato da issue #48578).
2. Ou faça o mesmo pelo PowerShell, como um usuário registrou na #48333:

   Stop-Process -Name codex -Force

   Atenção: esse comando encerra todos os processos codex, inclusive uma sessão do Codex CLI que esteja aberta em outro terminal.
3. Se não voltar, tente o outro caminho relatado na mesma issue: encerrar o processo de renderização principal do app. Para listar os candidatos:

   Get-CimInstance Win32_Process -Filter "Name='ChatGPT.exe'" |
     Where-Object CommandLine -like '*--type=renderer*' |
     Select-Object ProcessId, CommandLine

   Finalize o que tiver o menor --renderer-client-id com Stop-Process -Id <PID>. A janela se recupera em cerca de 5 segundos, segundo o relato.

É um contorno por inicialização: no próximo fechamento e reabertura o spinner tende a voltar, até sair um build corrigido. Até 28/09/2026 nenhuma das issues tinha resposta de mantenedor da OpenAI.

Ficou branco no meio do trabalho: o agente parou?

Não. Nesses relatos o agente continua executando em segundo plano, e só a janela para de desenhar. Encerre o processo de renderização e a interface volta sem fechar o app.

No macOS, a issue #46641 (app do ChatGPT 26.915.31945) mostra o processo Codex (Renderer) chegando a cerca de 120% de CPU e 3,2 GB de memória, com pico de 4,7 GB. No Windows, a #47110 (build 26.915.4065.0) registra o renderer em 2.973 MB enquanto a sessão seguia funcionando pelo app do celular.

No macOS: abra o Monitor de Atividade, procure Codex (Renderer) com CPU alta e use Forçar Encerramento só nele. Pelo terminal:

ps aux | grep -i codex | grep -i renderer
kill <PID>

No Windows: use o mesmo comando Get-CimInstance da seção anterior e finalize o renderer com mais memória.

O relato da #46641 é claro: encerrar só o renderer restaura a tela na hora, sem precisar fechar o ChatGPT. O problema costuma voltar depois de um tempo de uso.

Branco mesmo depois de reinstalar: o que sobrevive à reinstalação?

A pasta ~/.codex. Desinstalar o app não apaga essa pasta, e um config.toml corrompido dentro dela mantém a tela branca em qualquer instalação nova.

A issue #44374 documenta o caso: o config.toml tinha 2.700 bytes, todos 0x00. O Codex Desktop só mostrava branco; foi o Codex CLI que revelou o erro:

Error loading config.toml:
C:\Users\<username>\.codex\config.toml:1:2701
key with no value, expected '='

O que fazer:

1. Confira os primeiros bytes do arquivo. No Windows:

   Format-Hex "$env:USERPROFILE\.codex\config.toml" | Select-Object -First 2

   No macOS ou Linux:

   head -c 64 ~/.codex/config.toml | xxd

   Só zeros (00 00 00 ...) confirma a corrupção.
2. Renomeie o arquivo, em vez de apagar:

   Rename-Item "$env:USERPROFILE\.codex\config.toml" config.toml.bak

   mv ~/.codex/config.toml ~/.codex/config.toml.bak

3. Abra o app de novo. No relato, a interface voltou na hora e os projetos e o histórico continuavam lá. Refaça suas configurações num config.toml novo.

Volta sempre, só numa máquina: como achar o gatilho?

Teste com uma pasta ~/.codex limpa, renomeando a antiga. Se o app estabilizar, o gatilho está em algum arquivo do estado antigo, não na conta nem no build.

Foi assim que a #46641 isolou o problema: o mesmo build funcionava num MacBook e falhava num Mac mini, um usuário novo do macOS no próprio Mac mini funcionava, e limpar ~/Library/Application Support/OpenAI/Codex não resolveu. Com um ~/.codex vazio, o app voltou a funcionar normalmente.

# macOS / Linux, com o app fechado
mv ~/.codex ~/.codex-backup

# Windows (PowerShell), com o app fechado
Rename-Item "$env:USERPROFILE\.codex" .codex-backup

Não apague a pasta antiga: é nela que ficam suas sessões (sessions/) e o histórico. O mesmo relato conta que mover um arquivo de sessão ainda referenciado fez o app mostrar "unable to restore". Traga de volta o que precisar aos poucos, e deixe de fora arquivos de estado da interface, como .codex-global-state.json.

Precisa trabalhar agora: tem como usar o Codex sem a janela?

Sim. O Codex CLI não depende da janela do Desktop. Na issue #48578, com o app preso no spinner, o codex 0.157.0 no terminal seguia recebendo e respondendo prompts normalmente. Antes de abrir uma issue, rode o diagnóstico local e anexe a versão redigida:

codex doctor --json