Codex App (Desktop)

Se você não quer instalar o Codex CLI e só quer usar o cliente desktop Codex App, siga este método.

Passo 1 — Criar os arquivos de configuração

Local dos arquivos de configuração:

• Mac/Linux: a pasta .codex no seu diretório pessoal (~)
• Windows: C:\users\seu-usuario\.codex\

Se a pasta já existir, o ideal é apagar o config.toml que está dentro dela (e qualquer auth.json que tenha sobrado do guia antigo) e recriá-lo, para evitar interferência de configurações antigas.

Crie a pasta com um comando no terminal:

# Mac/Linux
rm -rf ~/.codex && mkdir ~/.codex

Crie o config.toml na pasta .codex.

config.toml

Configure o provedor de serviço; a chave de API vai em um cabeçalho de requisição no final do arquivo:

model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
sandbox_mode = "danger-full-access"
windows_wsl_setup_acknowledged = true
approval_policy = "never"
file_opener = "vscode"
model_provider = "codex"
web_search = "cached"
suppress_unstable_features_warning = true

[history]
persistence = "save-all"

[tui]
notifications = true

[shell_environment_policy]
inherit = "all"
ignore_default_excludes = false

[sandbox_workspace_write]
network_access = true

[features]
plan_tool = true
apply_patch_freeform = true
view_image_tool = true
unified_exec = false
streamable_shell = false
rmcp_client = true
elevated_windows_sandbox = true

[profiles.auto-max]
approval_policy = "never"
sandbox_mode = "workspace-write"

[profiles.review]
approval_policy = "on-request"
sandbox_mode = "workspace-write"

[notice]
hide_gpt5_1_migration_prompt = true

[model_providers.codex]
name = "codex"
base_url = "https://api.lmuai.com"
wire_api = "responses"

[model_providers.codex.http_headers]
Authorization = "Bearer your sk- key generated in the console"

Substitua a última linha pela sua chave sk-, mantendo um espaço entre Bearer e a chave. Coloque a seção [model_providers.codex.http_headers] no final do arquivo, sem nenhuma outra configuração depois dela.

Passo 2 — Reabrir o Codex App

Depois de salvar os arquivos de configuração, reabra o Codex App: ele fará login e estará pronto para uso automaticamente.

Ativando o contexto de 1M (opcional)

O gpt-5.4 suporta um contexto longo de 1M tokens, mas ele vem desativado por padrão. Adicione duas linhas no nível raiz do config.toml acima (antes de qualquer [section]) e depois reinicie o Codex App:

model_context_window = 1000000
model_auto_compact_token_limit = 900000

Para o significado dos campos, como verificar e as ressalvas, veja Ativando o contexto de 1M no Codex.

Erros comuns

Erro 401, chave incorreta:

Causa: a requisição continua indo para o endpoint oficial da OpenAI em vez do nosso relay de API, ou você não reiniciou a ferramenta para recarregar o arquivo de configuração.

Solução: siga o guia novamente para criar ou substituir o config.toml e depois reabra o aplicativo.

Erro 401 API_KEY_REQUIRED:

Causa: versões mais novas do Codex podem não ler mais a chave do auth.json, então a requisição vai sem chave.

Solução: adicione a seção [model_providers.codex.http_headers] no final do config.toml como mostrado acima; veja FAQ · Problema 10.

Última atualização: 2026-10-08

京ICP备2020034311号-7