Codex: chave de API ou ChatGPT, configuração e cobrança
Escolha entre o login com ChatGPT, uma chave oficial da API da OpenAI e um provedor de Responses com cobrança separada. Configure a BetterToken no config.toml do usuário, confira as restrições de país e cartão e verifique a autenticação, o provedor e o registro de uso antes de começar o trabalho.
Conteúdo

Se o Codex não permite fazer login ou o uso aparece em uma fatura inesperada, identifique a autenticação antes de trocar de plano. Para quem usa o Codex localmente, o login com ChatGPT utiliza os benefícios do plano; uma chave de API da OpenAI tem cobrança separada na OpenAI Platform. Com um provedor personalizado de Responses, confira o provedor selecionado e seus registros de uso, além de codex login status.
Escolha qual conta deve pagar
Em 2026-11-22, a documentação de autenticação da OpenAI distingue o acesso pela assinatura do acesso com chave de API. Um provedor externo acrescenta uma forma separada de cobrança pelo modelo, não uma assinatura do ChatGPT.
| Forma de acesso | O que é necessário | Onde o uso é cobrado | Quando escolher |
|---|---|---|---|
| Login com ChatGPT | Conta do ChatGPT em um local aceito; plano elegível e meio de pagamento aceito para recursos pagos | Franquia do plano e, quando aplicável, créditos do ChatGPT ou cobrança por uso | Você quer uso local incluído ou recursos do Codex cloud disponíveis para sua conta |
| Chave de API oficial da OpenAI | Chave da OpenAI Platform, cobrança da API configurada ou créditos de API utilizáveis, local aceito e meio de pagamento elegível quando for necessário pagar | OpenAI Platform, pelas tarifas da API, e não pela franquia do ChatGPT | Você precisa de trabalho local na CLI ou automação em ambiente confiável, com cobrança para uma organização de API |
| Provedor personalizado BetterToken | Sua própria conta BetterToken, chave de API e saldo disponível; as opções de pagamento dependem do console | Saldo da BetterToken, pelas tarifas de tokens do modelo escolhido | Você precisa de acesso local ao Codex com cobrança separada, incluindo uma opção de pagamento em rublos |
Configure a BetterToken para uma sessão local na CLI
Use o acesso ao Codex pela BetterToken com a CLI oficial do Codex já instalada. Confira os preços atuais de tokens e cache e abra o console.
Confirme que a conta tem saldo utilizável suficiente para o teste. Se necessário, adicione créditos por uma opção de pagamento disponível no console e confira se o saldo foi atualizado. Depois, crie sua própria chave de API seguindo as instruções de configuração da conta BetterToken.
O exemplo usa gpt-6.2-sol, listado com suporte a Responses em 2026-11-22. Ele utiliza a autenticação por variável de ambiente documentada no guia de Codex da BetterToken.
Encerre o Codex e guarde uma cópia da configuração em um local privado. Incorpore as opções abaixo ao ~/.codex/config.toml do usuário, mantendo as chaves de nível raiz antes de todas as tabelas. Substitua as opções correspondentes já existentes; não duplique chaves nem tabelas. Se CODEX_HOME estiver definido, edite o config.toml desse diretório.
model = "gpt-6.2-sol"
model_provider = "bettertoken"
[model_providers.bettertoken]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1"
wire_api = "responses"
env_key = "BETTERTOKEN_API_KEY"
requires_openai_auth = false
supports_websockets = false
No Bash, cole a chave quando read aguardar a entrada e pressione Enter. A entrada não aparece na tela. Inicie o teste em um diretório sem material confidencial do projeto.
read -rs BETTERTOKEN_API_KEY && export BETTERTOKEN_API_KEY
codex --sandbox read-only "Reply with exactly CODEX_ROUTE_OK. Do not use tools."
O Codex lê a chave da variável exportada e envia requisições de Responses para https://www.bettertoken.ai/v1/responses. Essa configuração não exige substituir auth.json nem fornecer a chave da BetterToken no login da OpenAI. Inicie o Codex nesse mesmo terminal para que ele receba a variável.
Confira se a resposta solicitada chegou e encontre no console da BetterToken o modelo, o horário, o status e a cobrança correspondentes. A resposta confirma a conexão; o registro correspondente confirma qual plataforma processou a requisição. Verifique a cobrança antes de abrir um repositório grande.
Criar uma conta na BetterToken
O que os dois métodos oficiais de login incluem?
Para acessar diretamente a OpenAI, siga as instruções oficiais de login. Escolha o ChatGPT para usar os benefícios do plano ou uma chave emitida pela OpenAI para ter cobrança na Platform. A configuração do provedor externo apresentada acima é outra forma de acesso.
Os dois métodos oficiais permitem trabalho local no Codex CLI, na extensão para IDE e no aplicativo de desktop do ChatGPT. O Codex cloud exige login com ChatGPT. A página de disponibilidade de recursos exclui do acesso com chave de API a revisão de código em nuvem no GitHub e a integração com Slack.
Escolha a autenticação com chave de API para trabalho local ou tarefas de CI em ambientes confiáveis, não para substituir os benefícios da nuvem. Os modelos disponíveis na API dependem do acesso da sua chave. Um plano superior do ChatGPT não transforma uma sessão com chave de API em uso incluído na assinatura.
Para voltar à OpenAI, defina model_provider = "openai" no nível raiz da configuração do usuário. Restaure também o valor anterior de model para a OpenAI ou escolha um modelo disponível com seu método oficial de login. Não mantenha model = "gpt-6.2-sol" do exemplo do gateway sem conferir o acesso ao modelo na sua conta oficial.
Remova qualquer configuração de openai_base_url usada para apontar para um gateway. Ao substituir credenciais salvas, execute codex logout primeiro. Execute codex login para entrar com ChatGPT.
Para o login oficial com chave de API, use uma chave emitida pela OpenAI. Estes comandos do Bash a fornecem pela entrada padrão, sem escrever seu valor no comando:
read -rs OPENAI_API_KEY && export OPENAI_API_KEY
codex login --with-api-key <<<"$OPENAI_API_KEY"
codex login status
Após fazer login, inicie uma nova sessão e repita o teste somente leitura acima com o modelo da OpenAI escolhido. Confirme a resposta. Depois, confira o painel de uso correspondente do ChatGPT ou da OpenAI Platform, conforme a seção de cobrança abaixo.
Mantenha a chave privada. As orientações de cobrança da OpenAI separam a cobrança da API da cobrança do ChatGPT, inclusive os créditos promocionais de API. Ao avaliar um benefício da assinatura, confira os requisitos e as exclusões dos créditos de API em vez de presumir que ele cobre o Codex.
E se seu país ou cartão não for aceito?
Uma chave de API oficial não elimina os requisitos de localização da OpenAI. Em 2026-11-22, a Rússia não consta na lista de países aceitos para a API nem na lista conjunta do ChatGPT e da API.
O erro "OpenAI's services are not available in your country." pode aparecer durante o cadastro ou a criação de uma chave de API. A política da OpenAI sobre países não aceitos alerta que acessos a partir desses países podem resultar na suspensão da conta. Ela também informa que meios de pagamento de países não aceitos causam bloqueio do acesso aos serviços.
O pagamento tem verificações separadas. Para pagar com cartão, tanto sua localização quanto o banco emissor devem estar em regiões aceitas. Cartões pré-pagos não podem comprar créditos de API, conforme as orientações sobre cartões recusados.
Para usuários na Rússia, a BetterToken aceita pagamentos em rublos sem o cartão estrangeiro normalmente necessário nas assinaturas oficiais dos fornecedores. Seu endpoint de API pode ser acessado sem VPN. Essa condição não abrange downloads, logins, lojas de aplicativos ou atualizações de terceiros. Canais de pagamento, cartões elegíveis, taxas e condições de compensação dependem do console.
Redefinir os dados do navegador só é pertinente se você estiver atualmente em um país aceito. Para erros de detecção relacionados a viagens, a OpenAI recomenda limpar cookies e cache ou tentar outro navegador. Se isso não resolver, entre em contato com o OpenAI Support.
Por que o Codex ignora meu provedor personalizado?
Coloque as opções do provedor na configuração do usuário, não no .codex/config.toml do repositório. A referência de configuração informa que as entradas model_provider e model_providers no nível do projeto são ignoradas. Marcar o projeto como confiável não altera essa restrição.
model_provider seleciona o identificador do provedor; [model_providers.bettertoken] define esse identificador. base_url indica a raiz da API, enquanto env_key nomeia a variável de ambiente que contém a credencial. Use um identificador próprio. Os identificadores integrados, incluindo openai, ollama e lmstudio, são reservados.
O único valor aceito para wire_api é responses. Um gateway que só aceita Chat Completions não atende a essa configuração. Use https://www.bettertoken.ai/v1 como URL base, não a URL completa da requisição com /responses.
Mantenha separados os modos de autenticação. A OpenAI documenta que requires_openai_auth = true faz o Codex ignorar env_key. O exemplo define esse campo explicitamente como false. Não o combine com uma configuração copiada de autenticação por arquivo que defina true.
supports_websockets = false mantém este exemplo no transporte HTTP/SSE. Deixe os ajustes opcionais fora do primeiro teste. O suporte a campos como service_tier precisa ser confirmado com o gateway; a existência de um campo no Codex não comprova esse suporte.
Se a configuração ainda parecer não ter efeito, confira CODEX_HOME e os valores sobrescritos pela linha de comando ou pelo perfil selecionado. Na CLI, /debug-config mostra as camadas de configuração e as origens das políticas. Reinicie o Codex com uma nova sessão após as alterações. O guia de configuração de provedores personalizados traz outras verificações de conexão.
Como confirmar qual conta recebe a cobrança?
Confira a autenticação, o destino das requisições e os registros de uso em conjunto. codex login status informa o modo de autenticação; não é um comprovante de cobrança. Com um provedor que usa env_key, não deduza onde o modelo é cobrado apenas porque há um login salvo do ChatGPT.
Execute o comando no mesmo ambiente usado para iniciar o Codex:
codex login status
Depois, confira os valores selecionados de model_provider e base_url. Dentro da sessão, /status mostra o modelo ativo e o uso de tokens. Compare esses dados com a requisição de teste antes de iniciar uma tarefa longa.
Para o login com ChatGPT, consulte o painel de uso do Codex para verificar o consumo da franquia. Confira as compras nas configurações de cobrança da conta ou do espaço de trabalho do ChatGPT. O uso incluído não precisa gerar uma cobrança monetária separada por requisição.
Para uma chave oficial de API, use os relatórios de uso da OpenAI Platform e as configurações de cobrança da organização de API. Confira o projeto, o modelo, a chave de API e o período do relatório corretos. Os horários do painel usam UTC, e atividades recentes podem demorar a aparecer.
Para a BetterToken, confira o registro da requisição e o saldo no console. O painel mostra horário, modelo, status, uso de tokens e cobranças. Não espere que essa cobrança apareça na sua conta pessoal da OpenAI Platform ou consuma a franquia do ChatGPT.
Se o teste falhar, corrija a causa correspondente
Se houver um erro de variável de ambiente ausente, informe a chave novamente e inicie o Codex pelo mesmo terminal do Bash. Diante de um 401 da BetterToken, confira se a chave pertence à BetterToken e continua válida. Um 402 indica saldo insuficiente.
Se a requisição for rejeitada por causa do formato, compare o protocolo e a URL base selecionados com a configuração mínima acima. Remova os campos opcionais específicos do provedor antes de testar novamente. A referência de Responses da BetterToken documenta 400 para formatos ou parâmetros de requisição inválidos.
Se a resposta chegar, mas o registro de uso esperado não aparecer, pare antes de enviar uma tarefa maior. Confira novamente o provedor, a origem da credencial, a conta do painel e o período do relatório. O nome do modelo ou um login bem-sucedido não bastam para comprovar onde a requisição foi cobrada.