Skip to main content
Codex CLI e Codex App compartilham config.toml e auth.json para tarefas locais. Esta configuração usa uma BetterToken API Key via OpenAI Responses.

​
Configurações principais

​
Pré-requisitos

​
Instalação

​
Localize os arquivos e faça backup

Se você definiu um CODEX_HOME personalizado, edite config.toml e auth.json nesse diretório. Caso contrário, use ~/.codex no macOS / Linux ou %USERPROFILE%\.codex no Windows. CLI e App devem usar o mesmo diretório. O WSL tem seu próprio diretório de usuário. Feche o Codex completamente antes de editar. Faça backup dos dois arquivos em um local privado. Crie os arquivos que faltarem. Substitua as configurações existentes sem duplicar chaves ou tabelas; preserve as demais configurações.
Esta configuração troca o login com ChatGPT pela autenticação com API Key. Ela não preserva o acesso à conta oficial. Proteja auth.json e seus backups; não os compartilhe nem os inclua no repositório.

​
Configuração pela linha de comando

O script de configuração automática do BetterToken grava a configuração do provedor para o Codex. Ele exige Node.js e solicita a API Key ou o Model ID quando esses valores não são informados como argumentos.
Após a instalação, compare os dois arquivos com a configuração manual abaixo e corrija as diferenças antes de iniciar o Codex.

​
Configuração manual

​
Edite config.toml

Coloque model_provider, model e cli_auth_credentials_store no nível superior, antes de todas as tabelas TOML, não dentro de um perfil. O ID do provedor deve corresponder ao nome da tabela. Para esta autenticação por arquivos, remova env_key e experimental_bearer_token do provedor selecionado.
O exemplo usa GPT-6 Astra (gpt-6-astra). Para outro modelo, copie o ID completo da model plaza e substitua model. GPT, Kimi e GLM usam a mesma estrutura de autenticação por arquivos; a configuração automática está disponível para GPT.

​
Edite auth.json

auth.json fica no mesmo diretório que config.toml. Se auth.json não existir, crie esse arquivo no mesmo diretório. Use o JSON abaixo como conteúdo do arquivo, substitua YOUR_API_KEY pela sua BetterToken API Key e salve o arquivo.

​
Verificar a conexão

Salve os dois arquivos. Inicie uma nova sessão do Codex CLI diretamente pelo terminal:
Feche o Codex App completamente, incluindo os processos em segundo plano. Abra-o novamente e crie uma nova tarefa local. Envie um prompt curto em cada cliente que usa. Uma resposta normal confirma a conexão desse cliente.

​
Trocar de modelo

Altere model e, opcionalmente, review_model. Salve o arquivo, encerre o processo atual do Codex e inicie-o novamente. Use o Model ID da caixa de diálogo Setup ou do model plaza.

​
Erros comuns

Em caso de 401, 403 ou solicitação de login, confira o diretório ativo, a Key em auth.json, auth_mode = apikey, cli_auth_credentials_store = file e requires_openai_auth = true. Para erros de provedor ou modelo, confira o ID do provedor, https://bettertoken.ai/v1, wire_api = responses e a disponibilidade do modelo. Se as alterações não forem aplicadas, verifique as opções que sobrescrevem a configuração e confirme que CLI e App usam o mesmo CODEX_HOME.

​
Configuração avançada

​
Provedores compatíveis

Os status se aplicam ao método de configuração do BetterToken descrito nesta página.
  • Configuração pela linha de comando e manual: use um comando gerado ou siga todas as etapas manuais.
  • Configuração manual: informe a API Key, a Base URL e o Model.
  • Sem suporte: ainda não há um método verificado de conexão direta.

​
Extensão Codex

A extensão Codex para VS Code compartilha config.toml, mas manter o login oficial exige uma configuração de autenticação diferente. Consulte o guia de configuração da extensão Codex.

​
Perguntas relacionadas

​
Referência oficial

​
Detalhes técnicos

O Codex usa OpenAI Responses. Defina base_url como https://bettertoken.ai/v1 e mantenha wire_api = "responses". O Codex acrescenta /responses.