lidge-jun /opencodex

Universal provider proxy for OpenAI Codex & Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code

★ 18,575⑂ 1,520👁 27⑃ 6,706● 1,984▤ 311
TypeScriptMITCreated 2026-06-18opencodex.me/
下载:v2.100.3v2.100.3 ↓2.100.32026-11-14
+19
日增长
18,575
stars
1,520
forks
27
watchers
6,706
prs
1,984
issues
311
releases

README

One local gateway for your AI coding tools and models.
Use the models you choose with Codex, Claude Code, Claude Desktop and Grok Build,
and connect OpenCode, Pi, Qoder, WorkBuddy, Kilo, Cline, T3 Code and more through managed configs.
See every supported tool →
Part of GOAT: run your coding agents on any model, on any machine → trygoat.ai


  
  
  
  


bash
npm install -g --allow-scripts=bun @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 gateway between your coding tools and your model providers. It
accepts the Responses, Chat Completions and Anthropic Messages APIs and translates each request into
whatever your provider speaks, carrying streaming, tool calls, reasoning and images where the client,
model and provider support them. Use Claude, Gemini, Grok, GLM, DeepSeek, Kimi, Qwen, Ollama and other
providers with Codex, Claude Code, Claude Desktop, Grok Build and the tools listed on the
client support page.

 Quick start

 Personal install (CLI)

bash
npm install -g --allow-scripts=bun @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.

 Connect your tool

Connect the tool you already use:

| Tool | How to connect |
|---|---|
| Codex | Turn on the Codex switch on the dashboard's Connect page, then run codex as usual. On a local listener this points Codex's built-in provider at the proxy. From the terminal, run ocx init before adding providers in the dashboard and accept its Codex prompt. |
| Claude Code | With the claude CLI installed, run ocx claude. It starts the proxy if needed and launches Claude Code through it. |
| Claude Desktop | Run ocx claude desktop. On a new install it sets up the gateway profile for the whole app; an existing first-party setup is kept, and ocx claude desktop apply --gateway switches explicitly. See the Claude Code guide. Fully quit and reopen Claude Desktop after a switch. |
| Grok Build | On a local listener with Grok integration enabled, ocx start registers the models when ~/.grok exists; pick an ocx- model in Grok Build. Remote setups: see the Grok Build guide. After adding providers, restart the proxy (or run ocx ensure when Codex aut

Top issues

Discussions

Latest release

v2.100.3 v2.100.3 2026-11-14
Published to npm as @bitkyc08/[email protected] with dist-tag latest.

 New Features

- Carry Claude Code's Advisor server tool on the translated Messages path (8516)
- Record the Anthropic pool account tag on each attempt (8520)
- Say why an API-key balance is unknown and when it was last read (8519)
- Opt-in admit policy for curated selections and honest arrival status (8511)
- Update, sync and restart Codex on linked Children from the Home (8513)
- Remember devices behind an operator-named reverse proxy (8518)
- Opt-in per-provider alias templates (8512)
- Ocx sync --child and --restart-chi

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON