Resposta curta
model_provider informa ao Codex CLI qual provedor deve ser usado. O valor precisa corresponder a um ID definido em [model_providers.<id>].
base_url é o endpoint para o qual as solicitações de modelo são enviadas. Em um provedor compatível com OpenAI, ele geralmente aponta para um endpoint com /v1.
wire_api informa ao Codex qual formato de protocolo usar ao se comunicar com o provedor. Na referência de configuração do Codex, responses é um valor de protocolo compatível.
Quando isso é importante
- Você está configurando um provedor personalizado compatível com OpenAI
- O Codex não encontra o provedor ou as solicitações falham
- Você não sabe a diferença entre
model_provider e model
- Você está adicionando BetterToken, OpenAI ou outro provedor a um
config.toml
- Você precisa separar Base URL, API Key e ID de modelo
Relação entre os campos
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.
Padrão recomendado
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.
Documentos relacionados
Referências
