CC Router

CC-Router

Local multi-account router for Claude Max and OpenAI ChatGPT/Codex subscriptions.
Distribute Claude Code requests across Claude subscriptions, and expose an OpenAI Responses-compatible route for Codex CLI through the same proxy.

Features

- Round-robin token rotation — distribute requests across 2-20 Claude Max accounts automatically
- Multi-provider routing — route openai/* models to OpenAI ChatGPT/Codex subscription accounts and Claude models to Claude subscriptions
- Transparent Claude proxy — Claude Code works normally; streaming, thinking, tool use, prompt caching all pass through
- Codex CLI support — configure Codex to use CC-Router as a Responses-compatible provider
- Automatic token refresh — OAuth tokens are refreshed before they expire, saved atomically to disk
- Rate limit awareness — detects 429/529 responses and coolsdown accounts; picks the least-loaded one
- Client mode — connect to a remote CC-Router from any machine with one command (cc-router client connect )
- Claude Desktop support — route Cowork / Agent-mode traffic through CC-Router via mitmproxy interception (macOS, Windows, Linux)
- Guided setup wizard — interactive cc-router setup extracts tokens from Keychain or credentials file, configures everything
- Live dashboard — real-time terminal UI showing account health, request counts, token usage, recent activity
- Proxy authentication — optional Bearer / x-api-key secret for internet-exposed deployments
- Auto-update — patch/minor releases install automatically (opt-out available)
- Multiple deployment modes — background daemon, native OS auto-start (launchd/systemd), foreground, Docker Compose
- Cross-platform — macOS, Linux, Windows; Node.js 20+

Warning
Read the disclaimer before using this tool.

How it works

All standard Claude…