opencodex — um proxy local para usar qualquer LLM no Codex

O Codex só funciona com modelos da OpenAI. Quer usar Claude? Quer programar com GLM-5.2? Você teria que esperar a OpenAI adicionar suporte.

opencodex é um proxy local que resolve esse problema. Ele fica entre o Codex e o provedor de LLM e traduz o protocolo em tempo real. Streaming, chamada de ferramentas, tokens de raciocínio, imagens — tudo funciona nos dois sentidos.

No seletor de modelos do app, CLI e SDK do Codex,
ele aparece registrado normalmente,
e dentro de uma mesma sessão é possível usar tanto GPT quanto todos os modelos registrados.

npm install -g @bitkyc08/opencodex  
ocx init      # escolher provedor  
ocx start     # iniciar proxy  
codex -m "anthropic/claude-opus-4-8" "corrija este bug"  

Como funciona

O Codex usa apenas seu próprio protocolo chamado Responses API (/v1/responses). A maioria dos LLMs não implementa isso. O opencodex faz a tradução com 5 adaptadores de protocolo (Anthropic Messages, Google Gemini, Azure, OpenAI passthrough, OpenAI-compatible Chat Completions). Mais de 40 provedores já vêm integrados por padrão.

Os modelos roteados aparecem no seletor de modelos do Codex como se fossem nativos. Basta especificar no formato provider/model.

Dificuldades ao desenvolver

Havia muitos projetos open source de design de proxy, então a implementação foi relativamente fácil,
mas para oferecer uma experiência realmente nativa no Codex foi essencial desmontar o codex-rs.

Mapeamento de reasoning effort. Cada provedor usa nomes diferentes para o effort. A GLM usa "max", enquanto o Codex chama isso de "xhigh". A Kimi rejeita esse parâmetro por completo. Foi preciso criar tabelas de conversão separadas por modelo.

Histórico de sessão. O Codex salva o model_provider de cada thread no banco de dados. Ao mudar para o opencodex, todas as sessões existentes deixam de aparecer. Foi criado um migrador que abre o SQLite diretamente e altera a tag model_provider durante inject/restore. O mtime dos arquivos é preservado para que a ordem de retomada não seja bagunçada.

Sidecar. Modelos que não são da OpenAI não conseguem fazer busca na web nem entender imagens. Essa funcionalidade foi roteada por meio de um sidecar gpt-5.4-mini com login do ChatGPT, para que Claude ou GLM também consigam fazer buscas reais na web.

Ao desligar, volta ao normal

Ao executar ocx stop, as configurações do Codex, o catálogo e o histórico de sessão são totalmente restaurados ao original. Não sobra nenhum resíduo. O botão Stop no dashboard ou ocx service uninstall também produzem o mesmo resultado.

Licença MIT. Nativo para macOS/Linux/Windows (WSL não necessário).

GitHub: https://github.com/lidge-jun/opencodex
npm: npm install -g @bitkyc08/opencodex