OpenCodex leva Claude e Gemini ao Codex com 8.616 estrelas
Proxy local em TypeScript traduz a API do Codex para mais de 40 provedores de modelos.
Proxy local em TypeScript traduz a API do Codex para mais de 40 provedores de modelos.
Quem quer usar Claude, Gemini ou DeepSeek dentro do OpenAI Codex não precisa trocar de fluxo: o OpenCodex funciona como um proxy local que conecta esses modelos ao Codex, ao Claude Code, ao Claude Desktop e ao Grok Build. Criado por lidge-jun em 2026-06-18, o projeto chegou a 8.616 estrelas e 652 forks em 51 dias. A ferramenta serve para desenvolvedores que querem manter as interfaces desses produtos e escolher o modelo por trás delas.
O OpenCodex roda como um proxy leve na máquina do usuário. Ele traduz a Responses API do Codex para o formato aceito pelo provedor escolhido e faz o caminho inverso com streaming, chamadas de ferramentas, tokens de raciocínio e imagens.
O código usa TypeScript e exige Node 18 ou superior. O pacote do npm instala um runtime Bun junto, então o usuário não precisa instalar o Bun separadamente. No Windows, também não precisa do WSL.
A interface de controle abre em http://localhost:10100. Dali, o usuário adiciona provedores, escolhe modelos e acompanha o status de OAuth e o registro de requisições. O comando ocx gui reabre o painel.
O proxy fica local, mas os modelos não. Claude, Gemini, Grok, GLM, DeepSeek, Kimi, Qwen e Ollama aparecem entre as opções, além de endpoints compatíveis com OpenAI. O acesso depende das contas, chaves ou serviços externos associados a cada provedor.
O projeto também cria sidecars para busca na web e análise de imagens em modelos que não oferecem esses recursos diretamente. Esses sidecars usam o login do ChatGPT. A ferramenta ainda oferece OAuth para xAI, Anthropic e Kimi.
A instalação acontece pelo npm, que também baixa o runtime incluído. Depois, o usuário inicia o proxy e abre o painel local para cadastrar provedores, modelos e contas.
Quem prefere automação pode usar ocx init, mas o comando não inicia o proxy. Com o serviço parado, comandos como ocx provider add e ocx combo set falham porque conversam com o proxy ativo.
A primeira execução interativa de ocx start pode perguntar se o usuário quer marcar o repositório com uma estrela. O CLI não mostra essa pergunta em execuções conduzidas por agentes, e a API recusa esse fluxo com 403 agent_consent_required.
O OpenCodex gerencia ainda um conjunto de contas do ChatGPT para autenticar o Codex. O painel atualiza cotas de 5h, semanais e de 30 dias, enquanto novas sessões podem escolher a conta saudável com menor uso.
Conversas existentes normalmente mantêm a conta que iniciou o thread. Falhas de autenticação, limites 429, expiração de afinidade, exclusões e reavaliações de cota podem mudar essa associação.
A versão mais recente é a v2.11.1, publicada no npm como @bitkyc08/[email protected] com a tag latest. Ela adiciona suporte ao cliente OMP, failover entre candidatos de política e um modelo de raciocínio definido pelo roteamento.
O último commit ocorreu em 2026-08-09, mesma data da versão. O repositório registra 107 issues abertas, número que merece atenção em um projeto com apenas 51 dias de vida, apesar da tração de 8.616 estrelas.
A licença MIT permite usar, alterar e redistribuir o código sob os termos dessa licença. A ferramenta não serve para quem procura um serviço hospedado que esconda a configuração de provedores: ela exige Node, roda um proxy local e depende das contas ou APIs externas escolhidas.