Provedor personalizado no Codex: model_provider, Base URL e wire_api

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

Campo	Finalidade
`model_provider`	Seleciona o ID do provedor ativo
`[model_providers.<id>]`	Define a configuração detalhada de um provedor
`name`	Nome exibido para o provedor
`base_url`	Endpoint raiz da API
`wire_api`	Protocolo do provedor, geralmente `responses`
`model`	ID padrão do modelo principal
`review_model`	Modelo usado em fluxos de revisão, como `/review`

Padrão recomendado

Mantenha o ID do provedor consistente:

model_provider = "custom"
model = "gpt-5.5"

[model_providers.custom]
name = "BetterToken"
base_url = "https://www.bettertoken.ai/v1"
env_key = "MODEL_PROVIDER_API_KEY"
wire_api = "responses"
requires_openai_auth = false

Isso significa que o Codex usa o provedor chamado custom, envia solicitações para https://www.bettertoken.ai/v1 e se comunica no formato da Responses API. Não coloque a API Key diretamente no config.toml. Defina-a no terminal que inicia o Codex:

export MODEL_PROVIDER_API_KEY="YOUR_API_KEY"

No Windows PowerShell:

$env:MODEL_PROVIDER_API_KEY="YOUR_API_KEY"

Verifique a configuração

Confirme que model_provider = "custom" corresponde exatamente a [model_providers.custom].
Confirme que a Base URL é https://www.bettertoken.ai/v1, incluindo /v1.
Copie um ID atual do provedor GPT na model plaza.
Encerre completamente o Codex e abra-o em um novo terminal no qual a variável de ambiente esteja definida.
Envie uma pequena tarefa de explicação de código e confirme que o Codex retorna uma resposta completa.

Solução de problemas

Sintoma	Causa	Correção
Provedor não encontrado	O ID do provedor e a tabela de configuração não correspondem	Use `custom` nos dois lugares
API Key ausente na inicialização	A variável indicada por `env_key` não está disponível	Defina `MODEL_PROVIDER_API_KEY` e abra um novo terminal
`401` ou `403`	API Key inválida ou autenticação OpenAI combinada incorretamente	Copie a chave novamente e defina `requires_openai_auth = false`
`404`	A Base URL não tem `/v1` ou aponta para um endpoint Anthropic	Use `https://www.bettertoken.ai/v1`
Modelo não encontrado	O valor é um nome de exibição, um modelo descontinuado ou não GPT	Copie um ID atual da model plaza
Erro do protocolo Responses	`wire_api` está ausente ou incorreto	Defina `wire_api = "responses"`

Claude Code

Claude Desktop

Codex

Cursor

Cline

Uso de modelos

Serviço e segurança

Custos e tokens

Conceitos

Provedor personalizado no Codex: model_provider, Base URL e wire_api

Resposta curta

Quando isso é importante

Relação entre os campos

Padrão recomendado

Verifique a configuração

Solução de problemas

Documentos relacionados

Referências

​Resposta curta

​Quando isso é importante

​Relação entre os campos

​Padrão recomendado

​Verifique a configuração

​Solução de problemas

​Documentos relacionados

​Referências

Resposta curta

Quando isso é importante

Relação entre os campos

Padrão recomendado

Verifique a configuração

Solução de problemas

Documentos relacionados

Referências