opencodex
A local proxy that lets Codex and Claude Code use models from other providers.
- Stars
- 18.2k
- Forks
- 1.4k
- Licence
- MIT
- Language
- TypeScript
- Last update
- 4 days ago
- Type
- Dev tool
What it is
opencodex runs on your computer as a local gateway between AI coding tools and model providers. It accepts requests in the Responses, Chat Completions and Anthropic Messages formats and translates them into what each provider expects. The README says this lets tools like Codex and Claude Code work with models such as Claude, Gemini, Grok, DeepSeek and Ollama.
- Run Codex with a non-OpenAI model by selecting a provider in the dashboard
- Start Claude Code through the proxy with the command ocx claude
- Add an OpenAI-compatible endpoint as a custom provider
- Use a ChatGPT account pool so new sessions route to the lowest-usage healthy account
Great for
- Developers who already use Codex or Claude Code and want to try other model providers
- People who want one local dashboard to manage multiple provider keys and models
- Users who want to route different sessions to different accounts or models
- Anyone running local models through Ollama who wants them inside a coding tool
Not ideal for
- People who only use one provider and do not need routing, since the proxy adds a layer to set up and maintain
- Users who need guaranteed feature parity; the README says streaming, tool calls, reasoning and images work only where the client, model and provider support them
- Non-technical users who are uncomfortable installing Node packages or editing tool configs
How to get it
- 1
Install with a package manager
You'll need: Node.js 18+ (the README says the Bun runtime is bundled automatically)
Install the CLI globally
npm install -g @bitkyc08/opencodexStart the proxy and dashboard
ocx start - 2
Run it
- Run npm install -g @bitkyc08/opencodex
- Run ocx start and open http://localhost:10100
- Add a provider or pick a model in the web dashboard
- Connect your tool, for example with ocx claude or the dashboard Connect page
- 3
Get the most out of it
- Use ocx service to run the proxy in the background
- Use the dashboard Connect page to enable managed integrations for supported tools
- Run ocx gui to reopen the dashboard at any time
- After adding providers, restart the proxy or run ocx ensure to refresh the model list, as the README describes for Grok Build
Downloads
Strengths
- Works with many clients and providers through one local address, http://localhost:10100
- Has a web dashboard for adding providers, picking models and managing accounts
- MIT licensed and open source on GitHub
Trade-offs
- The README describes support as conditional on client, model and provider, so behavior varies by combination
- Several setup paths (CLI, desktop app, managed integrations) mean more to learn; the README is long and partly truncated
- Desktop app is labeled beta in the README
How it compares
| Project | Stars | Type | Level | Updated | Best for |
|---|---|---|---|---|---|
| opencodex (this) | 18.2k | Dev tool | intermediate | 4 days ago | Developers who already use Codex or Claude Code and want to try other model providers |
| claude-code-router | 38k | Dev tool | intermediate | 27 days ago | Developers who use several coding agents and want one place to manage model providers |
| LibreChat | 46.6k | App | intermediate | 4 days ago | Teams that want one shared chat interface across several AI providers |
| one-api | 37.3k | App | intermediate | 10 months ago | Developers who want one OpenAI-compatible endpoint for several model providers |
| watermarks-remover | 25.9k | AI model / agent | intermediate | 5 days ago | Developers who use AI coding agents and want written files scrubbed of provenance metadata |
| ECC | 295k | Dev tool | intermediate | 4 days ago | Developers who already use Claude Code and want a shared workflow for planning, testing and review |
Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.