Codex CLI no saldo pré-pago, com um bloco de provider

O Codex CLI é o agente de programação de linha de comando da OpenAI. A configuração dele tem a opção model_provider, cujo valor padrão é openai, e assim as requisições vão para a interface da própria OpenAI. Essa opção pode ser trocada: defina o seu provider em config.toml, com o endereço do endpoint e o nome da variável de ambiente que guarda a chave, e aponte model_provider para ele. Os comandos e o uso do Codex continuam iguais; só muda quem cobra.

O Codex fala um único protocolo, a Responses API da OpenAI: a referência de configuração dele diz que wire_api só aceita o valor responses. Por isso, a primeira coisa a confirmar em um gateway é se ele oferece /v1/responses, e não apenas /v1/chat/completions. Aqui as duas rotas existem, e o Codex usa a primeira.

O bloco abaixo tem quatro linhas, e a API key não é escrita no arquivo. O que cada opção significa:

• model_provider escolhe o bloco pelo nome da tabela. Esse nome é você quem define, mas openai, ollama, lmstudio, amazon-bedrock, amazon-bedrock-runtime e gcp são ids embutidos do Codex e não podem ser sobrescritos.
• base_url recebe https://api.relayswitch.io/v1, com /v1; o Codex acrescenta /responses ao final.
• env_key é o nome da variável de ambiente que guarda a chave, não a chave em si. Como a chave fica na variável de ambiente, o arquivo de configuração pode ser commitado ou sincronizado com segurança.
• wire_api tem um único valor válido, responses, que também é o padrão, então essa linha pode ser removida.
• requires_openai_auth tem false como padrão e não precisa ser escrita: um provider personalizado usa a chave de env_key, e não o login da conta OpenAI.

Escreva o bloco em ~/.codex/config.toml. Esse diretório é definido pela variável de ambiente CODEX_HOME e o padrão é ~/.codex; o provider precisa estar nesse arquivo de nível de usuário. Depois, exporte a chave no terminal em que o Codex vai rodar e inicie. Acrescente a linha de export ao arquivo de configuração do shell para que novos terminais também a carreguem.

Antes de executar o Codex, envie uma requisição Responses pequena para confirmar que a chave e o endereço estão corretos. A opção -i mostra a linha de status e os headers da resposta, incluindo o id da requisição.

Se a resposta for 200, execute codex e envie o primeiro comando. A requisição aparece na página Usage do console em poucos segundos, com tokens e custo. Para trocar de modelo temporariamente, use codex --model seguido do id.

Esta tabela traz os modelos GPT do catálogo em USD por milhão de tokens, com preços separados de entrada, entrada em cache e saída. O Codex foi projetado para modelos GPT e para a rota Responses, então confirme que o id escrito no config.toml responde ao teste com curl acima.

O Codex reenvia a conversa e a saída das ferramentas a cada turno. Esses tokens são cobrados pelo preço de entrada em cache quando caem no cache, e a resposta informa quantos tokens vieram do cache; cair ou não depende do modelo e da própria requisição. Isso torna a economia concreta: use um modelo mais barato para as mudanças do dia a dia e passe para um mais caro só em reviews e refactors difíceis, comece uma sessão nova ao terminar uma tarefa para o contexto não crescer sem parar, e crie uma chave só para o Codex com orçamento em dólares e limite de gasto diário. Ao atingir o limite, o gateway responde 402 e só essa chave deixa de funcionar; o restante do saldo da conta fica intacto.

Um profile é um arquivo chamado ~/.codex/<name>.config.toml que contém só as linhas diferentes de config.toml e é aplicado por cima dele quando o Codex é executado com codex --profile <name>. Desde o Codex 0.134.0, as tabelas [profiles.<name>] dentro de config.toml não são mais lidas, e o seletor profile = no nível superior foi removido; tutoriais escritos antes disso ainda usam a forma antiga, que não funciona se for copiada. O valor de model_reasoning_effort segue os níveis suportados pelo modelo escolhido; o Codex o envia em toda requisição, e o gateway o repassa ao modelo sem alteração.

Com um provider personalizado, o menu /model do Codex continua mostrando os modelos embutidos da OpenAI, e não os do seu provider. Escolher um deles reescreve o arquivo de profile ativo: o modelo muda, o provider não. Se o id escrito existir no catálogo, o Codex roda pelo preço desse modelo; se não existir, a resposta é 404. Para trocar de modelo, use --profile ou --model.

Os status 401 a 404 são devolvidos antes de a requisição chegar ao modelo, e 429, 502 e 503 não trazem resposta; nenhum deles é cobrado. A tabela completa por status está na página OpenAI API. Para programar com o Claude no terminal, use o Claude Code; os dois rodam com a mesma chave e o mesmo saldo, e a criação da chave está na página Claude API key.