opencodex

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.

npm install -g @bitkyc08/opencodex
ocx start

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)

npm install -g @bitkyc08/opencodex   # Node 18+; the Bun runtime is bundled automatically
ocx start                         # proxy + dashboard on localhost:10100

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:

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 Bar App guide cover first launch, and AGENTS_INSTALL.md lists everything written to disk.

ChatGPT account pool

opencodex can also manage a ChatGPT account pool for Codex auth. Add multiple ChatGPT / Codex accounts, refresh their 5h / weekly / 30d quota in the dashboard. Under quota routing, new sessions can use the lowest-usage healthy account; round-robin and fill-first use their own policies. Existing Codex threads normally retain affinity to the account that started them, so long SSH, tmux, or mobile-connected sessions do not jump accounts mid-conversation — but quota re-evaluation, failover, account exclusion, affinity expiry, or 401/403 and 429 recovery can rebind them. Give the accounts a selection order when one of them — usually your Codex Desktop login — should only be reached for once the others are drained.

Sponsors

Sponsors keep opencodex maintained across every upstream protocol change. Interested? See SPONSORS.md.

Thanks to OrcaRouter for sponsoring this project! OrcaRouter is one OpenAI-compatible AI gateway for production AI: adaptive routing that grades every prompt and sends it to the model that clears your bar, automatic failover, routing rules as code, zero-markup provider pricing with prompt caching, and guardrails, an agent firewall, and request logs on every call across 200+ models. Pick OrcaRouter in the Add provider picker or run ocx provider add orcarouter; orcarouter/auto is the adaptive router. Thanks to TokenLab for sponsoring this project! TokenLab gives coding agents one API key for leading models, supporting OpenAI Responses and Chat Completions, Anthropic Messages, and Gemini's native API formats, with streaming and tool calling. It also provides an MCP server and agent Skills for easy integration. Choose your delivery mode and pay as you go. Pick TokenLab in the Add provider picker or run ocx provider add tokenlab.TokenLab 为编程智能体提供统一的多模型 API，一枚 API Key 即可接入主流模型，支持 OpenAI Responses、Chat Completions、Anthropic Messages 和 Gemini 原生 API 格式，以及流式输出和工具调用。同时提供 MCP 服务器和 Agent Skills，方便接入现有工作流；交付模式可选，按量付费。

Docker Compose

The repository ships a digest-pinned, non-root Compose build. The build generates and verifies the