Opencodex is a local proxy to route Codex requests to multiple LLM providers (OpenAI, Anthropic, Google Gemini, Ollama, etc.). It includes a CLI, app integration, and dashboard for provider management and model routing.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (2 so far).
What it is
Universal provider proxy for OpenAI Codex & Claude Code — use any LLM with Codex CLI, App, SDK, and Claude Code. It translates Codex's Responses API into the provider's API, enabling streaming, tool calls, reasoning tokens, and images across providers. It also manages a ChatGPT account pool for Codex auth and supports routing among multiple providers and models.
How it works
opencodex sits between Codex and external LLM providers. It routes Codex requests through to a chosen provider, and returns responses back to Codex. It supports multiple providers/adapters (OpenAI, Anthropic, Google Gemini, Azure, Ollama, OpenRouter, etc.), model routing, and delegation to sub-models. It can inject into Codex CLI, TUI, App, and SDK, and exposes models in Codex’s picker. It also manages provider auth, quotas, and failover behavior for pool accounts.
Getting started
# Install (bundles Bun runtime automatically)
npm install -g @bitkyc08/opencodex
# Interactive setup (writes config, injects into Codex, and offers autostart shim)
ocx init
# Start the proxy
ocx start
# If you skipped it during init, install the on-demand autostart shim later
ocx codex-shim install
# Use Codex normally — it now routes through opencodex
codex "Write a hello world in Rust"
Details about bundled Bun runtime and troubleshooting are included in the Quick start section of the README.
Getting started (continued)
ocx gui
This opens the web dashboard at http://localhost:10100 for provider management and configuration. You can add providers, configure accounts, and map models.
Recent releases
- v2.7.28 (2026-07-20): CI fix, proxy timeout increase, antigravity improvement, etc.
- v2.7.28-preview.20260720 (2026-07-20): Published to npm as
@bitkyc08/opencodex@2.7.28-preview.20260720with dist-tagpreview. - v2.7.27 (2026-07-20): Published to npm as
@bitkyc08/opencodex@2.7.27with dist-taglatest. - v2.7.26 (2026-07-19): Published to npm as
@bitkyc08/opencodex@2.7.26with dist-taglatest.
Traction
- Stars: 961
Behind the repo
- Repository is linked to a project that exposes a dashboard and multiple provider adapters. (No additional startup/company details provided beyond repo content and description.)
Caveats
- License: MIT
- Created: 2026-06-18
- Last push: 2026-07-20
- Open issues: 21
- Language: TypeScript
- Requires Node 18+; Bun runtime is bundled automatically on npm install
- Complex multi-provider routing with OpenAI, Claude, Gemini, Ollama, etc.; details and limitations described in the README (e.g., delegation behavior and known limitations with cross-provider delegation)