Ferramentas de código
OpenCodex
Conecte o Codex ao TokenLab através do OpenCodex com roteamento de API específico para cada modelo
Deixe meu agente configurar isso
Copie esta tarefa para um agente que já esteja rodando no seu computador:
Read https://tokenlab.sh/docs/pt/integrations/opencodex and help me connect OpenCodex to TokenLab.
Check my installed OpenCodex and Codex versions, active configuration, and running proxy first.
Preserve existing accounts, providers, models, and permissions. Back up files before changing them.
Have me enter the API key locally; never ask for, print, or paste it in chat.
Use the TokenLab preset and the selected model's documented API format.
Check configuration loading first. Explain the cost before running a small real request.
Match the reply with its TokenLab request record.Como a conexão funciona
O OpenCodex é um proxy local entre o Codex e as APIs de modelos. Este guia utiliza 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 específico para modelos e de Anthropic Messages. As rotas listadas abaixo foram verificadas com o TokenLab utilizando texto via streaming e ciclos de chamada/resultado de funções.
O Codex envia solicitações de Responses para o proxy local do OpenCodex. O OpenCodex então envia a solicitação do modelo selecionado para o TokenLab. Uma solicitação de Responses na conexão local não significa que o modelo seja chamado através da API de Responses do TokenLab.
| Modelos selecionados no Codex | OpenCodex → TokenLab |
|---|---|
gpt-6-astra, gpt-6.1-sol, gpt-6-sol, gpt-6-luna, grok-4.7, deepseek-v4.1-flash, deepseek-v4-pro, kimi-k3, glm-5.3 | Responses: POST /v1/responses |
claude-opus-5, claude-opus-5-5, claude-sonnet-5, claude-sonnet-5-5, claude-fable-5, claude-fable-5-1 | Anthropic Messages: POST /v1/messages |
gemini-3.8-flash | Chat Completions: POST /v1/chat/completions |
A Base URL do preset é https://api.tokenlab.sh/v1. Mantenha-a inalterada: o OpenCodex constrói a URL de Messages ou Responses correspondente por conta própria. Modelos fora dos padrões de Responses listados e do roteamento do Claude utilizam o adaptador de 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 através de Chat Completions. Não altere todo o provedor para Responses ou Gemini; isso também alteraria as solicitações para modelos que não aceitam esse formato.
Instalação ou atualização
Use o Node.js 18 ou superior para a instalação via npm:
npm install -g @bitkyc08/opencodex@2.73.0
ocx --version
codex --versionO Codex também deve estar instalado. O OpenCodex fornece instruções de instalação e instruções de conexão com o Codex. Windows nativo e 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 a configuração via terminal, siga o Início Rápido para definir a 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 ambiente ${TOKENLAB_API_KEY}. Revise as escolhas de conexão com o Codex e de inicialização automática do assistente antes de aplicá-las.
Para uma instalação existente, adicione o preset sem substituir outros provedores:
ocx provider add tokenlab --api-key '${TOKENLAB_API_KEY}'As aspas simples salvam uma referência de variável de ambiente, não o valor da chave. Este comando também funciona no PowerShell. Se o 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 rodando, então abra seu painel:
ocx start
ocx status
ocx guiNa página do provedor, verifique a Base URL e os modelos descobertos. O preset descobre 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, então inicie uma nova sessão do Codex. Isso altera a conexão de proxy e o catálogo do Codex; revise as configurações de provedores personalizados existentes e mantenha um backup antes de sincronizar. Isso não requer a substituição da sua conta ou política de permissões.
Selecionar um modelo e verificar uma solicitação
Escolha a entrada tokenlab/<model-id> no seletor de modelos do Codex, ou selecione-a para uma inicialização via CLI:
codex -m "tokenlab/gpt-6.1-sol"O OpenCodex usa tokenlab/ para selecionar o provedor; o ID do modelo enviado ao TokenLab é gpt-6.1-sol. Escolha um ID exato disponível atualmente em Models.
Para uma pequena verificação de conexão, envie:
Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.Esta solicitação utiliza seu saldo do TokenLab. Verifique a resposta e seu modelo, hora e status correspondentes em Requests. A descoberta do provedor e a inicialização bem-sucedida por si só não verificam o acesso à inferência.
Streaming e chamadas de função funcionam nas rotas da tabela. A entrada de imagem e os controles de pensamento dependem do modelo selecionado: verifique suas capacidades e use apenas as opções de esforço que o OpenCodex oferece para aquele modelo. A entrada de imagem e as solicitações de pensamento foram verificadas em modelos representativos para as rotas de Responses e Messages; a entrada de imagem do Gemini foi verificada em sua rota de Chat. Um modelo que suporta pensamento não necessariamente expõe texto de pensamento ou suporta todos os níveis de esforço.
Manter um modelo de Responses em Chat Completions
Para usar o caminho de Chat para um dos modelos de Responses listados, mescle uma entrada modelAdapters no objeto providers.tokenlab existente na configuração do OpenCodex. Este exemplo mantém o gpt-6-astra em Chat para o Codex:
{
"modelAdapters": {
"gpt-6-astra": "openai-chat"
}
}Este é um exemplo de campo de provedor, não uma substituição para a configuração completa. Preserve outras substituições de modelo, credenciais e provedores, então reinicie o proxy e abra uma nova sessão do Codex. Remover apenas esta entrada de modelo restaura seu padrão de Responses.
O roteamento de Messages do Claude está vinculado ao endpoint canônico do TokenLab. A substituição de Chat acima se aplica aos padrões de Responses; ela não altera o Claude para Chat. Para um cliente nativo de Chat, os modelos de Responses listados já usam Chat sem essa substituição. Veja OpenCodex provider routing.
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. Escolher Chat, Responses ou Messages é separado de escolher uma política de entrega; veja TokenLab provider settings.
TokenLab Skills adicionam instruções de integração. Elas não alteram o provedor ou 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 de MCP é uma operação separada; não coloque uma chave do TokenLab no campo de credenciais da TypeSafe.
Gerar imagens e vídeos no mesmo agente
O Codex também pode criar imagens e vídeos curtos com o servidor MCP do TokenLab. Cada geração é paga a partir do mesmo saldo do TokenLab. O OpenCodex apenas roteia solicitações de modelos, e o próprio Codex inicia servidores MCP. Adicione o servidor ao Codex no terminal onde a TOKENLAB_API_KEY está definida:
codex mcp add \
--env TOKENLAB_MCP_TOOL_PROFILE=core \
--env TOKENLAB_API_KEY="$TOKENLAB_API_KEY" \
tokenlab -- \
npx -y @tokenlabai/mcp-server@0.6.48O MCP não altera o provedor ou o formato de API do modelo principal. Execute codex mcp list e verifique se tokenlab está listado. Então tente em uma nova sessão do Codex:
Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.create_video retorna um ID de tarefa. O agente chama get_task_status até que o vídeo esteja pronto.
Solução de problemas e restauração da sua configuração
- TokenLab está faltando no seletor: verifique
ocx --version; este guia tem como alvo a versão 2.73.0. Atualize o catálogo comocx synce inicie uma nova sessão do Codex. - 401 ou credenciais faltando: verifique se a chave está ativa e disponível para o processo que executa o OpenCodex. Uma variável de ambiente em um terminal diferente não atualiza um serviço que já está rodando.
- Modelo faltando: 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-usenão estão incluídos neste preset. - Solicitação não suportada ou endpoint incorreto: compare o modelo selecionado com a tabela de roteamento e inspecione as substituições de adaptador salvas. O formato necessário é
tokenlab.accepted_request_formatsem model details; a lista de modelos não substitui esse campo de detalhes. Claude e Gemini não devem ser enviados para Responses apenas porque o Codex usa Responses localmente. - Falha em ferramentas ou entrada de imagem: mantenha o erro original e o ID da solicitação. 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 os resultados de ferramentas para ocultar um erro.
Para parar de rotear o Codex através do proxy, use ocx stop; o OpenCodex para o proxy e restaura a conexão nativa do Codex. ocx restore restaura a conexão nativa enquanto mantém o proxy rodando para outros clientes. Revise a OpenCodex CLI reference antes de alterar uma instalação compartilhada por outros clientes.