Local proxy

Use any LLM with Codex and Claude Code.

opencodex runs on your machine and speaks the Codex Responses API, the Claude Messages API and Grok Build — then routes each turn to whichever provider you pointed it at.

Get startedGitHub

• Anthropic
• Google
• xAI
• Kimi
• Ollama
• Groq
• OpenRouter
• Azure
• DeepSeek
• GLM

OverviewScreensFeaturesQuickstartDocs

One endpoint

Point Codex at localhost and change providers without touching the client again.

Stays on your machine

The proxy, its config and its history are local. Nothing is uploaded to run it.

Undo is real

Deletions are snapshotted before and after, so recovery does not depend on luck.

DashboardLive proxy status, the cost meter, and a Launch card that installs what is missing.

ProvidersGrouped by state, searchable, with raw JSON when the form is not enough.

ModelsChoose what reaches Codex’s picker. Hidden models stay callable by exact id.

TerminalRun commands without a console window appearing, with what you sent recorded beside the output.

Version historyAppend-only. Restoring records a new revision, so an undo can itself be undone.

Regex builderFeeds every search bar with a .* toggle. Evaluated locally, never transmitted.

Routing

Any provider

One endpoint in front of Anthropic, Google, xAI, DeepSeek, Ollama, OpenRouter and more.

Combos

Virtual models that fail over, or spread load by weighted round-robin.

Sub-agents

Choose the five models spawn_agent may offer, with per-depth ceilings.

Accounts

Account pooling

Sticky session affinity, 429 cooldown and failover across every OAuth provider.

Nothing you delete is gone

Every account, key and setting is snapshotted to a local git history before it changes.

Usage and cost

Local token accounting. Missing usage is shown as missing, never as zero.

Clients

Claude Code

GPT and Gemini inside Claude Code, with or without a Claude account.

Grok Build

Models registered straight into your Grok configuration.

Launcher and terminal

Install and open the agent CLIs, or run commands without leaving the app.

Operating it

Docker

A supervising entrypoint, so the dashboard’s restart works inside a container.

Remote access

Expose the proxy to your LAN behind a required credential.

Headless parity

Anything the dashboard can do, the CLI can do. A test enforces it.

1. 1
   npm install -g @bitkyc08/opencodexInstall
2. 2
   ocx initInject a provider into Codex
3. 3
   ocx startStart the proxy
4. 4
   codex "Write a hello world in Rust"Codex now routes through ocx

Full installation guide

Getting Started

• Installation
• Quickstart
• How It Works

Guides

• Providers
• Model Routing
• Codex Integration
• Claude Code
• Launcher & Terminal
• Web Dashboard
• Docker
• Sub-agent Surface

Reference

• CLI
• Configuration
• Adapters
• Architecture

Project

• Contributing
• GitHub
• npm