opencodex — un proxy local para usar cualquier LLM en Codex

Codex solo funciona con modelos de OpenAI. ¿Quieres usar Claude? ¿Quieres programar con GLM-5.2? Tienes que esperar a que OpenAI lo agregue.

opencodex es un proxy local que resuelve este problema. Se coloca entre Codex y el proveedor de LLM para traducir el protocolo en tiempo real. Streaming, llamadas a herramientas, tokens de razonamiento, imágenes: todo funciona en ambos sentidos.

La app, CLI y SDK de Codex
quedan registrados correctamente en el selector de modelos
y dentro de una misma sesión se pueden usar tanto GPT como todos los modelos registrados

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

Cómo funciona

Codex solo usa su propio protocolo llamado Responses API (/v1/responses). La mayoría de los LLM no lo implementan. opencodex lo traduce con 5 adaptadores de protocolo (Anthropic Messages, Google Gemini, Azure, OpenAI passthrough y OpenAI-compatible Chat Completions). Viene con más de 40 proveedores integrados por defecto.

Los modelos enrutados aparecen en el selector de modelos de Codex como si fueran modelos nativos. Solo hay que especificarlos en formato provider/model.

Lo difícil al crearlo

El diseño del proxy fue relativamente fácil de implementar porque ya existen muchos proyectos open source,
pero para lograr una experiencia nativa en Codex fue indispensable desarmar codex-rs.

Mapeo de reasoning effort. Cada proveedor usa nombres distintos para effort. GLM usa "max" y Codex lo llama "xhigh". Kimi directamente rechaza este parámetro. Hubo que crear tablas de conversión separadas para cada modelo.

Historial de sesiones. Codex guarda el model_provider de cada hilo en su base de datos. Si cambias a opencodex, todas las sesiones existentes dejan de verse. Se creó un migrador que abre SQLite directamente y cambia la etiqueta model_provider al hacer inject/restore. También preserva el mtime de los archivos para que no se altere el orden de reanudación.

Sidecar. Los modelos que no son de OpenAI no pueden hacer búsqueda web ni comprensión de imágenes. Mediante login de ChatGPT, esta función se enruta con un sidecar gpt-5.4-mini, para que Claude o GLM también puedan hacer búsquedas web reales.

Al apagarlo, todo vuelve a como estaba

Si ejecutas ocx stop, la configuración de Codex, el catálogo y el historial de sesiones se restauran por completo a su estado original. No queda ningún residuo. El mismo resultado se obtiene con el botón Stop del dashboard o con ocx service uninstall.

Licencia MIT. Nativo para macOS/Linux/Windows (no requiere WSL).

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