> ## Documentation Index
> Fetch the complete documentation index at: https://docs.4096bytes.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex Desktop

> Use o 4096bytes no Codex Desktop

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](/pt-BR/clients/codex), abra ou reinicie o Codex Desktop. Não é necessário criar outra API Key.

## Pré-requisitos

* Você concluiu [Criar conta](/pt-BR/quickstart/create-account).
* Você concluiu [Obter API Key](/pt-BR/quickstart/get-api-key).
* O Codex Desktop está instalado.
* A janela **Use key** está aberta para a API Key que você quer usar.

<Warning>
  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.
</Warning>

## Instalar

Baixe e instale o Codex Desktop pela [documentação do OpenAI Codex app](https://developers.openai.com/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](/pt-BR/clients/codex) para acesso pelo terminal.

## Copiar configuração do painel

<Steps>
  <Step title="Abrir API Keys">
    Abra o painel e vá para **API Keys**.
  </Step>

  <Step title="Escolher Codex CLI">
    Encontre a chave que será usada no Codex Desktop, clique em **Use key** e escolha **Codex CLI**.
  </Step>

  <Step title="Escolher o sistema">
    Selecione **macOS / Linux** ou **Windows**. O painel mostra os caminhos dos arquivos de configuração.
  </Step>

  <Step title="Gravar a configuração local">
    Siga os passos do sistema correspondente na página [Codex](/pt-BR/clients/codex) para gravar `config.toml` e `auth.json`.
  </Step>

  <Step title="Reiniciar o Codex Desktop">
    Salve a configuração, feche totalmente o Codex Desktop e abra novamente.
  </Step>
</Steps>

## Caminhos dos arquivos

| Sistema       | `config.toml`                      | `auth.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](/pt-BR/clients/codex) para entender cada campo.

## Verificar

Abra o Codex Desktop, escolha um projeto local e envie uma tarefa de baixo risco:

```text theme={null}
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

<AccordionGroup>
  <Accordion title="Já configurei o Codex CLI. Preciso repetir?">
    Não. O Codex Desktop lê a mesma configuração em `~/.codex/`. Feche totalmente o Codex Desktop e abra novamente.
  </Accordion>

  <Accordion title="Codex Desktop ainda usa o modelo ou endereço antigo">
    Coloque a nova configuração no início de `config.toml`. Salve, feche totalmente o Codex Desktop e abra novamente.
  </Accordion>

  <Accordion title="Codex Desktop mostra falha de autenticação">
    Verifique se `auth.json` é JSON válido. Confirme que a API Key não tem caracteres faltando, quebras de linha ou espaços extras.
  </Accordion>

  <Accordion title="Codex Desktop não encontra o modelo">
    `model` e `review_model` devem corresponder exatamente ao nome exibido no painel. Não copie nomes de capturas de outros usuários.
  </Accordion>
</AccordionGroup>