Provedor personalizado do Codex CLI/App: config.toml, API Key e Base URL

O Codex CLI e o Codex App se conectam ao BetterToken por OpenAI Responses. O arquivo de configuração é ~/.codex/config.toml, e a API Key é fornecida por BETTERTOKEN_API_KEY.

Configurações principais

Campo	Valor
API Key	Variável de ambiente `BETTERTOKEN_API_KEY`
Base URL	`https://www.bettertoken.ai/v1`
Model	`YOUR_MODEL_ID`

Pré-requisitos

Instale o Node.js
Crie uma BetterToken API Key
Copie um Model ID do model plaza ou da caixa de diálogo Setup da Key

Instalação

npm install -g @openai/codex

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.

macOS / Linux
Windows

curl -fsSL "https://bettertoken.ai/install-codex-provider.sh" | bash

iwr "https://bettertoken.ai/install-codex-provider.ps1" -OutFile "$env:TEMP\install-codex-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-codex-provider.ps1"

Quando o script terminar, abra ~/.codex/config.toml (ou %USERPROFILE%\.codex\config.toml no Windows), confirme se model, review_model e o provedor BetterToken foram gravados corretamente e reinicie completamente o Codex.

Configuração manual

GPT, Kimi e GLM usam a mesma estrutura de config.toml. Substitua apenas YOUR_MODEL_ID por um Model ID atual do provedor selecionado. A configuração pela linha de comando em um único comando está disponível atualmente apenas para GPT.

Definir a API Key

macOS / Linux
Windows PowerShell

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

Adicione esta linha a ~/.zshrc ou ~/.bashrc para mantê-la.

[Environment]::SetEnvironmentVariable("BETTERTOKEN_API_KEY", "YOUR_API_KEY", "User")
$env:BETTERTOKEN_API_KEY = "YOUR_API_KEY"

Não coloque uma BetterToken API Key em ~/.codex/auth.json. Esse arquivo é usado pelo login oficial do Codex; um provedor personalizado deve ler a variável de ambiente por env_key.

Configurar config.toml

Edite ~/.codex/config.toml:

model_provider = "custom"
model = "YOUR_MODEL_ID"
review_model = "YOUR_MODEL_ID"
model_reasoning_effort = "high"

[model_providers.custom]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1"
env_key = "BETTERTOKEN_API_KEY"
wire_api = "responses"
requires_openai_auth = false
request_max_retries = 4
stream_max_retries = 8
stream_idle_timeout_ms = 300000
supports_websockets = false

model_provider = "custom" deve corresponder à tabela [model_providers.custom]. Substitua os dois valores YOUR_MODEL_ID por um Model ID completo e atual.

Verificar a conexão

Abra um novo terminal e execute:

codex

Envie uma tarefa curta. Uma resposta em streaming sem erros de login, 401 ou modelo confirma a configuração.

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

Erro	Solução
`401` ou solicitação de login da OpenAI	Verifique `BETTERTOKEN_API_KEY` e confirme `requires_openai_auth = false`.
Provedor não encontrado	Faça `model_provider = "custom"` corresponder a `[model_providers.custom]`.
Erro no modo API	Mantenha `wire_api = "responses"`; não mude para Chat Completions.
Modelo não encontrado	Substitua `YOUR_MODEL_ID` por um ID completo e atual da caixa Setup ou do model plaza.
A configuração não foi aplicada	Abra um novo terminal, verifique a variável de ambiente e reinicie completamente o Codex.

Configuração avançada

Provedores compatíveis

Provedor	Status
Claude	Sem suporte
GPT	Linha de comando e configuração manual
Kimi	Configuração manual
GLM	Configuração manual

Os status se aplicam ao método de configuração do BetterToken descrito nesta página.

O que significa cada método de configuração

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.

A configuração de CLI/App e a configuração da extensão com login oficial são alternativas. Não cole duas tabelas [model_providers.custom] no mesmo arquivo TOML.

Perguntas relacionadas

Referência oficial

Referência de configuração do Codex

Detalhes técnicos

Protocolo Responses

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

Primeiros passos

Configuração de Coding Agents

Configuração de plataformas de aplicações de IA

Configuração avançada

Provedor personalizado do Codex CLI/App: config.toml, API Key e Base URL

Configurações principais

Pré-requisitos

Instalação

Configuração pela linha de comando

Configuração manual

Definir a API Key

Configurar config.toml

Verificar a conexão

Trocar de modelo

Erros comuns

Configuração avançada

Provedores compatíveis

Extensão Codex

Perguntas relacionadas

Referência oficial

Detalhes técnicos

​Configurações principais

​Pré-requisitos

​Instalação

​Configuração pela linha de comando

​Configuração manual

​Definir a API Key

​Configurar config.toml

​Verificar a conexão

​Trocar de modelo

​Erros comuns

​Configuração avançada

​Provedores compatíveis

​Extensão Codex

​Perguntas relacionadas

​Referência oficial

​Detalhes técnicos

Configurações principais

Pré-requisitos

Instalação

Configuração pela linha de comando

Configuração manual

Definir a API Key

Configurar config.toml

Verificar a conexão

Trocar de modelo

Erros comuns

Configuração avançada

Provedores compatíveis

Extensão Codex

Perguntas relacionadas

Referência oficial

Detalhes técnicos