duolahypercho/codex-router — explained in plain English
Analysis updated 2026-05-18
Add Kimi, DeepSeek, Grok, or Claude models to the Codex app's built in model picker.
Try Claude Desktop's experimental third-party inference gateway with alternate model providers.
Keep separate provider logins and API keys isolated per app instead of sharing one config.
Monitor usage and health for the active AI provider from a macOS menu bar panel.
| duolahypercho/codex-router | jianshuo/ccglass | gaearon/react-transform-catch-errors | |
|---|---|---|---|
| Stars | 181 | 181 | 183 |
| Language | JavaScript | JavaScript | JavaScript |
| Last pushed | — | — | 2016-04-18 |
| Maintenance | — | — | Dormant |
| Setup difficulty | moderate | easy | easy |
| Complexity | 4/5 | 2/5 | 2/5 |
| Audience | developer | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires Node.js 22.19+, Git, and either uv or Python 3.10+ with venv, each model provider needs its own login or API key.
Codex Router lets you use AI models from other companies, such as Anthropic, Kimi, DeepSeek, and xAI, inside AI desktop apps that normally only work with their own built in models. It does this by running a small local program on your own computer that sits between the app and these outside models, keeping your login credentials for each provider separate and isolated from one another. It currently supports the Codex app and command line tool as a stable target, with experimental support for Claude Desktop and the Cursor editor. Installing support for one app does not change the settings of another, and the project is an independent community effort not affiliated with any of the companies whose models it connects to. Setup is meant to be guided rather than manual. You can either paste a prepared instruction into an AI coding agent so it installs everything for you, or run a provided install script for macOS, Linux, or Windows. The installer walks you through choosing which providers to connect, detects logins you already have, lets you sign in to some providers directly, and asks for API keys through a hidden terminal prompt rather than displaying them on screen. It does not make any billed test request unless you specifically ask it to. Using it requires the target app itself, a recent version of Node.js, either the uv tool or Python with a virtual environment, and Git. Once connected, supported models such as different Kimi, DeepSeek, Grok, and Claude versions appear in the app's own model picker, each tied to its own authentication method, which may be an existing account login or a separately billed API key. Codex Router adds only a small, clearly marked block to the app's configuration file so it can find the router, while leaving your existing accounts, profiles, and settings untouched. On macOS there is also an optional menu bar control panel that shows usage and health information for whichever provider you are actively using. Because Codex Router runs entirely on your own machine and stores keys locally with restricted file permissions, it is aimed at people comfortable running command line tools and installers, rather than a fully hosted service.
A local router that lets AI desktop apps like Codex and Claude Desktop use outside models such as Kimi, DeepSeek, and Grok through one credential-isolated setup.
Mainly JavaScript. The stack also includes JavaScript, Node.js, Python.
The README does not state a license.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Verify against the repo before relying on details.