Skip to main content

​
Deixe meu agente configurar isso

Copie esta tarefa para um agente que já esteja em execução no seu computador:

​
Como funciona a conexão

O OpenCodex é um proxy local entre o Codex e as APIs de modelos. Este guia usa o OpenCodex 2.73.0 e o Codex CLI 0.149.0. A integração de Chat Completions do preset do TokenLab foi lançada e verificada de ponta a ponta na versão 2.72.0. A versão 2.73.0 mantém essa integração e adiciona roteamento de Responses e Anthropic Messages específico por modelo. As rotas listadas abaixo foram verificadas com o TokenLab utilizando texto transmitido via streaming e round trips de chamadas/resultados de funções. O Codex envia requisições Responses para o proxy local do OpenCodex. O OpenCodex então envia a requisição do modelo selecionado para o TokenLab. Uma requisição Responses na conexão local não significa que o modelo seja chamado por meio da Responses API do TokenLab. A Base URL do preset é https://api.tokenlab.sh/v1. Mantenha-a inalterada: o próprio OpenCodex constrói a URL correspondente de Messages ou Responses. Modelos fora dos padrões listados de Responses e do roteamento do Claude usam o adaptador Chat do preset. O TokenLab suporta a API nativa do Gemini para modelos que a declaram, mas o preset do TokenLab no OpenCodex 2.73.0 chama o Gemini via Chat Completions. Não altere o provedor inteiro para Responses ou Gemini; isso também alteraria as requisições para modelos que não aceitam esse formato.

​
Instalar ou atualizar

Use o Node.js 18 ou posterior para a instalação via npm:
O Codex também deve estar instalado. O OpenCodex fornece instruções de instalação e instruções de conexão com o Codex. O Windows nativo e o WSL possuem configurações separadas; execute a configuração e o Codex no mesmo ambiente.

​
Adicionar o TokenLab

Crie uma chave em TokenLab API Keys. Para configuração via terminal, siga o Início Rápido para definir TOKENLAB_API_KEY sem colocar seu valor no histórico de comandos. Inicie o OpenCodex a partir desse terminal; um serviço em segundo plano precisa da variável em seu próprio ambiente de inicialização. Para uma instalação nova do OpenCodex, execute ocx init, selecione TokenLab e insira a chave localmente ou use a referência literal de variável de ambiente ${TOKENLAB_API_KEY}. Revise as opções de conexão com o Codex e inicialização automática do assistente antes de aplicá-las. Para uma instalação existente, adicione o preset sem substituir outros provedores:
As aspas simples salvam uma referência à variável de ambiente, e não o valor da chave. Este comando também funciona no PowerShell. Se tokenlab já existir, edite esse provedor no painel em vez de sobrescrevê-lo com --force. Você também pode escolher TokenLab na lista Add provider do painel e inserir a chave lá. O OpenCodex salva sua configuração em $OPENCODEX_HOME/config.json, normalmente ~/.opencodex/config.json. Inicie o proxy se ele ainda não estiver em execução e, em seguida, abra seu painel:
Na página do provedor, verifique a Base URL e os modelos descobertos. O preset detecta GET /v1/models?category=chat e mantém modelos com capacidade de tool-use. Imagens, vídeo, áudio, embeddings e modelos de decisão são excluídos. A descoberta com uma chave reflete as permissões de modelo e a política de entrega dessa chave. Execute ocx sync para conectar o Codex e atualizar seu catálogo de modelos, e então inicie uma nova sessão do Codex. Isso altera a conexão proxy e o catálogo do Codex; revise as configurações existentes de provedores personalizados e mantenha um backup antes de sincronizar. Não é necessário substituir sua conta ou política de permissões.

​
Selecionar um modelo e verificar uma requisição

Escolha a entrada tokenlab/<model-id> no seletor de modelos do Codex ou selecione-a para uma única inicialização da CLI:
O OpenCodex usa tokenlab/ para selecionar o provedor; o ID do modelo enviado ao TokenLab é gpt-6.1-sol. Escolha um ID exato atualmente disponível em Modelos. Para uma verificação rápida de conexão, envie:
Esta requisição consome o seu saldo do TokenLab. Verifique a resposta e o modelo correspondente, horário e status em Requests. A descoberta de provedores e a inicialização bem-sucedida, por si só, não comprovam o acesso à inferência. Streaming e chamadas de função funcionam nas rotas da tabela. Entrada de imagem e controles de raciocínio dependem do modelo selecionado: verifique suas capacidades e use apenas as opções de esforço que o OpenCodex oferece para esse modelo. A entrada de imagem e as requisições de raciocínio foram verificadas em modelos representativos para as rotas Responses e Messages; a entrada de imagem do Gemini foi verificada em sua rota Chat. Um modelo com suporte a raciocínio não necessariamente expõe o texto de raciocínio nem suporta todos os níveis de esforço.

​
Manter um modelo Responses em Chat Completions

Para usar o caminho de Chat para um dos modelos Responses listados, mescle uma entrada modelAdapters no objeto existente providers.tokenlab na configuração do OpenCodex. Este exemplo mantém o gpt-6-astra em Chat para o Codex:
Este é um exemplo de campo do provedor, não uma substituição para a configuração completa. Preserve outras substituições de modelo, credenciais e provedores, depois reinicie o proxy e abra uma nova sessão do Codex. A remoção apenas dessa entrada de modelo restaura seu padrão de Responses. O roteamento Messages do Claude está vinculado ao endpoint canônico do TokenLab. A substituição de Chat acima aplica-se aos padrões de Responses; ela não muda o Claude para Chat. Para um cliente nativo de Chat, os modelos Responses listados já usam Chat sem essa substituição. Consulte o roteamento de provedores do OpenCodex.

​
Política de entrega e outras ferramentas do TokenLab

O preset não força um cabeçalho X-TokenLab-Delivery-Policy. O TokenLab usa o padrão de política de entrega da sua chave de API. A escolha entre Chat, Responses ou Messages é independente da escolha de uma política de entrega; consulte as configurações de provedor do TokenLab. Adicione o servidor MCP do TokenLab para outras ferramentas de API, ou as TokenLab Skills para instruções de integração. Isso não altera o provedor nem o formato de API do modelo principal. O JEV Auto no OpenCodex 2.73.0 usa o backend de decisão da TypeSafe. Ele não oferece o TokenLab como esse backend. Chamar a System One API do TokenLab através do MCP é uma operação separada; não insira uma chave do TokenLab no campo de credenciais da TypeSafe.

​
Solução de problemas e restauração da sua configuração

  • O TokenLab não aparece no seletor: verifique ocx --version; este guia tem como alvo a versão 2.73.0. Atualize o catálogo com ocx sync e inicie uma nova sessão do Codex.
  • 401 ou credenciais ausentes: verifique se a chave está ativa e disponível para o processo que executa o OpenCodex. Uma variável de ambiente em outro terminal não atualiza um serviço que já está em execução.
  • O modelo está ausente: verifique o ID exato, as permissões da sua chave e a disponibilidade atual. Modelos que não são de chat e modelos de chat sem tool-use não estão incluídos neste preset.
  • Requisição não suportada ou endpoint incorreto: compare o modelo selecionado com a tabela de roteamento e inspecione as substituições de adaptadores salvas. O formato necessário é tokenlab.accepted_request_formats nos detalhes do modelo; a lista de modelos não substitui esse campo de detalhe. Claude e Gemini não devem ser enviados para Responses apenas porque o Codex usa Responses localmente.
  • Falha nas ferramentas ou na entrada de imagem: guarde o erro original e o Request ID. Verifique as capacidades do modelo e a rota ativa do OpenCodex antes de alterar as configurações; não remova o histórico da conversa ou resultados de ferramentas para ocultar um erro.
Para parar de rotear o Codex pelo proxy, use ocx stop; o OpenCodex interrompe o proxy e restaura a conexão nativa do Codex. O comando ocx restore restaura a conexão nativa mantendo o proxy em execução para outros clientes. Revise a referência da CLI do OpenCodex antes de alterar uma instalação compartilhada com outros clientes.