whatisgithub

What is opencodex?

lidge-jun/opencodex — explained in plain English

Analysis updated 2026-05-18

3,409TypeScriptAudience · developerComplexity · 3/5Setup · easy

In one sentence

A local proxy that lets Codex and Claude Code work with any LLM provider, including Claude, Gemini, and local Ollama models.

Mindmap

mindmap
  root((opencodex))
    What it does
      Proxies Codex requests
      Routes to any LLM
      Works with Claude Code
    Tech stack
      TypeScript
      Node.js
      Bun runtime
    Use cases
      Swap Codex model provider
      Balance ChatGPT account quotas
      Route per-request model choice
    Audience
      Developers
      AI tool power users
      CLI coding assistant users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Use Claude, Gemini, or DeepSeek models inside OpenAI's Codex CLI or App

USE CASE 2

Route Claude Code requests through a chosen non-Anthropic provider

USE CASE 3

Manage a pool of ChatGPT accounts and auto-balance Codex usage across them

USE CASE 4

Switch a coding assistant's underlying model per request without restarting anything

What is it built with?

TypeScriptNode.jsBun

How does it compare?

lidge-jun/opencodexgloridust/wechatoncloudweb-infra-dev/rsbuild
Stars3,4093,3233,305
LanguageTypeScriptTypeScriptTypeScript
Last pushed2026-06-26
MaintenanceActive
Setup difficultyeasymoderateeasy
Complexity3/54/53/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

A single npm install bundles its own runtime, adding a provider needs an API key or OAuth login.

So what is it?

opencodex is a local proxy that lets you use any large language model, including Claude, Gemini, Grok, DeepSeek, GLM, Kimi, Qwen, or a local Ollama model, with OpenAI's Codex CLI, app, and SDK, as well as with Claude Code. Normally these coding tools only speak to one provider's API, so opencodex sits in between and translates Codex's own request format into whatever format the chosen provider expects, in both directions, including streaming responses, tool calls, reasoning tokens, and images. Setup is a single global npm install, which also bundles the Bun runtime automatically so nothing else needs installing separately. After that, an interactive setup command writes a config file and wires opencodex into Codex, and a start command launches the proxy that Codex then talks to through a local address on your machine. It runs on macOS, Linux, and Windows, and can install itself as a background service on each so it starts automatically. The project ships with a web dashboard where a user picks from more than 40 built in providers, or types in a custom endpoint, pastes an API key or logs in through OAuth for a few of them, and models are then discovered automatically from that provider's own model list. New providers work immediately without restarting anything. Once configured, a model can be chosen per request using a provider slash model naming pattern, so a single Codex session can be pointed at Claude, Gemini, a local Ollama model, or many others just by changing that name. If no provider is specified, opencodex guesses from the model name itself. For teams or heavy users relying on ChatGPT accounts for Codex authentication, opencodex can also manage a pool of multiple accounts, track each one's usage quota, and automatically route new sessions to whichever account has the most quota left, while keeping an existing conversation pinned to the account it started with so a long running session does not switch accounts partway through.

Copy-paste prompts

Prompt 1
Help me install opencodex and connect it to my Codex CLI so I can use Claude instead of GPT
Prompt 2
Show me how to add a new LLM provider through the opencodex web dashboard
Prompt 3
Explain how to target a specific model like anthropic/claude-opus-4-8 from the Codex CLI
Prompt 4
Walk me through setting up opencodex's ChatGPT account pool for quota balancing
Prompt 5
Help me troubleshoot the bundled Bun runtime missing error during opencodex install

Frequently asked questions

What is opencodex?

A local proxy that lets Codex and Claude Code work with any LLM provider, including Claude, Gemini, and local Ollama models.

What language is opencodex written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Bun.

How hard is opencodex to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is opencodex for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.