Pular para o conteúdo principal
O Codex Desktop usa a mesma configuração local do Codex CLI. Instale o Codex Desktop primeiro e depois grave o config.toml e o auth.json gerados pelo painel no diretório de configuração do Codex. Se você já concluiu a configuração de Codex, abra ou reinicie o Codex Desktop. Não é necessário criar outra API Key.

​
Pré-requisitos

  • Você concluiu Criar conta.
  • Você concluiu Obter API Key.
  • O Codex Desktop está instalado.
  • A janela Use key está aberta para a API Key que você quer usar.
A API Key em auth.json fica salva localmente em texto simples. Não envie ~/.codex/auth.json, capturas de tela ou saída do terminal para repositórios ou conversas.

​
Instalar

Baixe e instale o Codex Desktop pela documentação do OpenAI Codex app. Depois da instalação, abra o aplicativo e conclua a configuração inicial exibida pelo Codex Desktop. Se o Codex Desktop ainda não estiver disponível para o seu sistema, use Codex CLI para acesso pelo terminal.

​
Copiar configuração do painel

1

Abrir API Keys

Abra o painel e vá para API Keys.
2

Escolher Codex CLI

Encontre a chave que será usada no Codex Desktop, clique em Use key e escolha Codex CLI.
3

Escolher o sistema

Selecione macOS / Linux ou Windows. O painel mostra os caminhos dos arquivos de configuração.
4

Gravar a configuração local

Siga os passos do sistema correspondente na página Codex para gravar config.toml e auth.json.
5

Reiniciar o Codex Desktop

Salve a configuração, feche totalmente o Codex Desktop e abra novamente.

​
Caminhos dos arquivos

Sistemaconfig.tomlauth.json
macOS / Linux~/.codex/config.toml~/.codex/auth.json
Windows%USERPROFILE%\.codex\config.toml%USERPROFILE%\.codex\auth.json
Se você usa Codex dentro do WSL, configure o diretório ~/.codex/ do WSL, não o diretório de usuário do Windows. Use os valores de model, review_model, base_url e API Key exibidos no painel. Veja a página Codex para entender cada campo.

​
Verificar

Abra o Codex Desktop, escolha um projeto local e envie uma tarefa de baixo risco: 
Descreva em uma frase a finalidade do projeto atual. Não modifique arquivos.
Se o Codex Desktop responder sem erro de autenticação ou de modelo, a configuração está ativa.

​
Problemas comuns

Não. O Codex Desktop lê a mesma configuração em ~/.codex/. Feche totalmente o Codex Desktop e abra novamente.
Coloque a nova configuração no início de config.toml. Salve, feche totalmente o Codex Desktop e abra novamente.
Verifique se auth.json é JSON válido. Confirme que a API Key não tem caracteres faltando, quebras de linha ou espaços extras.
model e review_model devem corresponder exatamente ao nome exibido no painel. Não copie nomes de capturas de outros usuários.