📈 GH Trending Explorer 🎲 Surprise me

← all repos

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)

2026-10-20 · 17,683 ★ 2026-10-22 · 17,755 ★
LanguageTypeScript
LicenseMIT
Created2026-06-18 (4mo ago)
Last pushtoday
Watchers25
OwnerUser

GitHub topics

Links

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