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.
Atualize o Codex antes de usar gpt-6-astra.
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.
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.
Reinicie e verifique
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.
Solução de problemas
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.
Guias relacionados
