Codex (CLI da OpenAI)

Rode novas tarefas locais do Codex pela Responses API com streaming da OneProvider.

CLI e app de desktop do agente de código Codex

O que funciona

Aceita respostas em streaming, chamadas de função, ferramentas locais como apply_patch e contagem de consumo. Isso muda as novas tarefas locais da CLI, do desktop e da IDE; não muda os chats em nuvem do Codex.

Limitação do cliente

Reinicie o Codex e crie uma nova tarefa local depois de trocar o provedor. As tarefas existentes mantêm o modelo e o provedor com que começaram.

Configuração

1. Instale ou confira o Codex

   Se codex --version já mostrar uma versão, siga em frente. Senão, instale a CLI mais recente.

   npm install --global @openai/codex
   codex --version

2. Deixe uma chave dedicada disponível

   Crie uma chave dedicada da OneProvider e exporte-a na mesma sessão de terminal que inicia o Codex.

   export ONEPROVIDER_API_KEY="sk-your-key-here"

3. Adicione o provedor personalizado

   Abra ~/.codex/config.toml (no desktop: Settings → Configuration → Open config.toml, ou seja, Configurações → Configuração → Abrir config.toml) e adicione o provedor OneProvider.

   model_provider = "oneprovider"
   model = "gpt-6.1-sol"
   [model_providers.oneprovider]
   name = "OneProvider"
   base_url = "https://api.oneprovider.dev/v1"
   env_key = "ONEPROVIDER_API_KEY"
   wire_api = "responses"

4. Reinicie e teste uma nova tarefa local

   Quem usa a CLI deve rodar um teste somente leitura. Quem usa o desktop precisa fechar por completo, reabrir e iniciar uma nova tarefa local.

   codex

Verificar a conexão

Confirme a requisição no seu Dashboard

A requisição concluída deve mostrar o modelo escolhido, /v1/responses, o consumo de tokens e o valor debitado.

Dados da conexão

Protocolo

responses

Endpoint

https://api.oneprovider.dev/v1

Segurança da chave

Use uma chave dedicada com escopo limitado. No macOS, um app de desktop aberto pelo Dock pode não herdar as variáveis de ambiente do terminal; use a autenticação do Keychain baseada em comando do Codex em vez de colocar o segredo no config.toml.

Qual modelo escolher

Defina model no mesmo config.toml, abaixo de model_provider. gpt-6.1-sol é o nível de ponta para tarefas agênticas difíceis, gpt-6.1-terra é o padrão equilibrado do dia a dia e gpt-5.6-luna é o nível de baixo custo para alto volume e tarefas rápidas. O Codex fala a Responses API, então escolha IDs GPT na página de modelos ; os valores estão na página de preços .

Erros comuns e soluções

401 ou “missing credentials”

O Codex não enxerga ONEPROVIDER_API_KEY. Exporte-a no terminal que inicia o Codex. No macOS, um app de desktop aberto pelo Dock não a herda: use a autenticação do Keychain baseada em comando.

404

base_url deve ser https://api.oneprovider.dev/v1 com /v1, e wire_api deve ser "responses".

O Codex ainda usa o modelo ou o provedor antigo

As tarefas existentes mantêm o provedor com que começaram. Reinicie o Codex e crie uma nova tarefa local.

“You've hit your usage limit” ou o Codex pede para eu entrar no ChatGPT

Esse é o limite de uma assinatura do ChatGPT: a requisição foi para o ChatGPT, então o provedor OneProvider não está ativo. Coloque model_provider = "oneprovider" bem no topo do config.toml, acima de qualquer [table] (sem aspas “inteligentes”), feche o Codex por completo e inicie uma nova tarefa local. Depois saia do ChatGPT com codex logout (no app de desktop: nas configurações dele) e inicie codex no terminal em que ONEPROVIDER_API_KEY está exportada: com o provedor ativo, ele funciona só com a chave. Teste rápido: codex -c model_provider=oneprovider. wire_api aceita apenas "responses".

429 “Insufficient balance”

O saldo ou o limite da chave acabou. Recarregue o saldo; tentar de novo não resolve.

Perguntas frequentes

Isso muda os chats em nuvem do Codex?

Não, só as novas tarefas locais da CLI, do desktop e da IDE.

Preciso de uma conta OpenAI?

Não, a chave da OneProvider a substitui nas tarefas locais.

Posso usar modelos Claude no Codex?

O Codex usa a Responses API com IDs GPT. Para o Claude, use o Claude Code .

Onde confiro o custo?

Na página Consumo do Dashboard: cada requisição mostra o modelo, /v1/responses e o valor debitado.

Respostas rápidas

Qual base URL devo usar?

O Claude Code e os SDKs da Anthropic usam https://api.oneprovider.dev. Os SDKs da OpenAI e os clientes compatíveis com a OpenAI usam https://api.oneprovider.dev/v1. Uma única chave funciona nos dois; a lista de modelos está na página de modelos e os preços, na página de preços .

Como me autentico?

Envie a chave sk-… pura em x-api-key ou em Authorization: Bearer: um dos dois, nunca ambos. Guarde a chave em uma variável de ambiente, não em um arquivo que vai para o commit. Mais sobre autenticação .

Onde consigo uma chave?

Abra o seu painel no bot do Telegram @oneprovider_robot ou em app.oneprovider.dev, recarregue o saldo e toque em “Emitir chave”. Cada chave pode ter o seu próprio limite de gastos. Painel e chaves de API .

O que significam 401, 404 e 429?

401: a chave está ausente, foi digitada errado ou enviada no cabeçalho errado; cole a chave inteira, sem aspas nem espaços. 404: em geral, uma base URL errada, por exemplo um /v1 ausente ou duplicado. 429 com “Insufficient balance”: o saldo do painel ou o limite de gastos da chave acabou, então recarregue em vez de tentar de novo; qualquer outro 429 é um limite de requisições, então aguarde o tempo de Retry-After. Detalhes: códigos de erro e solução de problemas .

Por que os streams são cortados ou reiniciados?

VPNs e proxies VLESS costumam armazenar SSE em buffer ou quebrar a negociação do HTTP/2. A OneProvider não tem restrições regionais e não armazena streams em buffer; desative o proxy e tente de novo.

Onde pergunto se isso não bastar?

Escreva para @Oneproviderhelpbot no Telegram ou abra “Suporte” no painel web, informando o código de status HTTP e a mensagem de erro exata. Como funciona o suporte .