lidge-jun / opencodex
git clone https://github.com/lidge-jun/opencodex.git
v2.89.0 · 2d ago
Universal provider proxy for OpenAI Codex & Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code
+27
stars, 24h · #552
+~189
stars, 7 days · #688
+~810
stars, 30 days · #668
18k
★ total · +1% this week
1.4k
forks · 150 open issues
Star history (as recorded here)
LanguageTypeScript
LicenseMIT
Created2026-06-18 (4mo ago)
Last pushtoday
Watchers25
OwnerUser
GitHub topics
ai-gatewayai-toolsanthropicchatgptclaudeclaude-codecodexcodex-clideepseekdeveloper-toolsgeminigrokkirollmllm-proxyollamaopenaiopenrouterproxytypescript
Links
- GitHub: github.com/lidge-jun/opencodex
- Homepage: https://opencodex.me/
- Releases · Issues · Hacker News mentions
README excerpt
make codex open! Universal provider proxy for OpenAI Codex, Claude Code, Claude Desktop & Grok Build Two commands, and every one of them runs any LLM you point it at. [code] ### Claude Code, running any model The picker is stock Claude Code. The brain behind it isn't. ### Codex, running any model Pick a provider and go — same workflow, different brain. ### Claude Desktop, running any model Opus answers, then hands the task to a GPT-5.6 Sol subagent. ### Grok Build, running any model Sol drives the session and calls a Kimi K3 subagent. English · Français · 한국어 · 简体中文 · 繁體中文 · Русский · 日本語 · Türkçe · 📖 Full documentation → opencodex is a lightweight local proxy that translates Codex's Responses API into whatever your provider speaks — streaming, tool calls, reasoning tokens, images, in both directions. Use Claude, Gemini, Grok, GLM, DeepSeek, Kimi, Qwen, Ollama, or any other LLM with Codex, Claude Code, Claude Desktop, and Grok Build. It can also manage a **ChatGPT account pool** for Codex auth: add accounts, refresh their quotas in the dashboard, and let new sessions auto-route to the lowest-usage healthy account while existing threads stay pinned to the account that started them. ## Quick start ### Personal install (CLI) [code] Use `ocx service` to run it in the background. Open **http://localhost:10100** and configure everything in the web dashboard — add providers (40+ built-ins, or any OpenAI-compatible endpoint), pick models, manage accounts. `ocx gui` re-opens the dashboard at any time. Desktop app (beta) The desktop app is the same proxy and dashboard in a native window, with a tray and bundled `ocx`. It attaches to a proxy that is already running, or starts its bundled one, and the dashboard stays on the proxy port (**http://localhost:10100** unless you configured another). Pick the file for your platform from the latest release: | Platform | File | Notes | |---|---|---| | macOS 13+ (Apple Silicon and Intel) | `OpenCodex- -macos.dmg` | Universal build, signed with a Developer ID and notarized | | Windows (x64) | `OpenCodex- -windows-x64.msi` | Code signing via SignPath Foundation is rolling out (code signing policy); until a release is signed, SmartScreen asks once: choose **More info → Run anyway** | | Linux (x86_64) | `OpenCodex- -linux-x86_64.AppImage` or `-linux-amd64.deb` | The tray needs an AppIndicator-capable desktop | Every file has a `.sha256` next to it on the release page. On macOS 14+ the app also ships a WidgetKit extension that shows proxy status, today's usage and provider quotas; the snapshot model it renders lives in `app/` (`MenuBarCore`). To build the app yourself, run `bun install && bun run build:gui` at the repository root, then in `desktop/` run `bun install && bun run prepare-sidecar && bun run prepare-widget && bun run build:local` on macOS, or `bun install && bun run prepare-sidecar && bun run build:local` on Windows and Linux (the widget step needs macOS). The Desktop App guide and the macOS Menu Ba