Skip to content
opencodex

Run on any LLM.

opencodex is a local proxy that serves Codex and Claude Code from one port — translating each wire format to any provider, with streaming, tool calls, reasoning, and images in both directions. Zero client patches.

Get StartedGitHub
  • Anthropic
  • Google
  • xAI
  • Kimi
  • Ollama Cloud
  • Groq
  • OpenRouter
  • Azure
  • DeepSeek
  • GLM
  • 40+ providers
The opencodex dashboard — live proxy status, routed providers, and available models

Install.

Start.

Codex, rerouted.

zsh
$ npm install -g @bitkyc08/opencodex  # Install
$ ocx start  # Start the proxy
Full quickstart →

Watch Codex run on a routed model.

Codex App running a task on a routed non-OpenAI model

One task, streamed end to end through opencodex.

One proxy, the whole surface.

Any provider

Five adapters cover Anthropic Messages, Google Gemini, Azure, the OpenAI Responses passthrough, and every OpenAI-compatible Chat Completions endpoint — 40+ built-in providers.

OAuth or API key

Log in with your xAI, Anthropic, or Kimi account — auto-refreshed — forward your ChatGPT login, or paste a key.

ChatGPT account pool

Existing threads keep their account; new sessions auto-route to the lowest-usage healthy one after quota refresh.

Native in the model picker

Routed models show up in Codex App with reasoning effort levels, next to the native ones.

Codex App model picker with reasoning effort levels

Sub-agents

Pin up to five routed or native models for Codex spawn_agent, and switch the v1 / base / v2 surface globally.

Claude Code

ocx claude launches Claude Code against the same port — every routed model in the /model picker, auto-context up to 1M, roster sub-agents, and your claude.ai login stays active.

Search & vision sidecars

Give non-OpenAI models real web search and image understanding through a gpt-5.4-mini sidecar.

Quickstart

ocx init writes a provider into your Codex config and shares one model catalog with Codex CLI, TUI, App, and SDK. ocx stop restores native Codex cleanly.

zsh
$ npm install -g @bitkyc08/opencodex  # Install
$ ocx init  # Inject a provider into Codex
$ ocx start  # Start the proxy
$ codex "Write a hello world in Rust"  # Codex now routes through ocx

Explore the docs

Getting Started

Guides

Reference

Project

opencodex is an independent community project, not affiliated with or endorsed by OpenAI, Anthropic, or any other provider. Some providers may restrict accounts that route traffic through third-party proxies — review each provider’s Terms of Service before connecting.