← all repositories
zyycn/codex-proxy-rs

A Rust gatekeeper for your pile of Codex accounts

Codex Proxy RS pools multiple Codex accounts behind one self-hosted gateway, with keys, groups, and usage tracking per client.

codex-proxy-rs
Collecting fresh signals — velocity needs a few days of history.
collecting data…
star history

What it does It’s a self-hosted proxy gateway for OpenAI’s Codex: you register multiple upstream accounts, group them however you like, and hand out client API keys that can see only the groups you choose. A built-in admin panel shows system overview, account groups, proxy management, and usage statistics. It ships as a Docker Compose stack with PostgreSQL and Redis, and there’s a public demo instance with mock data if you want to poke at the UI before deploying.

The interesting bit It speaks the Responses API only — no /v1/chat/completions — so it’s aimed squarely at Codex CLI and desktop users rather than generic chat clients. There’s also a plugin system with an SDK and packaging tool, which is more extensibility than most proxy projects bother with.

Key highlights

  • Multi-account pooling with per-key group scoping; a key with no group can use all accounts
  • Admin panel with usage stats, plus a separate API-key-holder view for quotas and Codex config export
  • Client onboarding via copy-paste config or CCSwitch import
  • Plugin architecture with documented SDK and plugin CLI
  • Apache 2.0, CI-gated releases, published container images

Caveats

  • Responses API only — chat-completions clients won’t work
  • The default bind is localhost; remote access needs your own HTTPS reverse proxy
  • The README is thin on the “low risk-control” claims in the repo description — no details on how that’s actually achieved

Verdict Worth a look if you juggle several Codex accounts and want centralized keys, quotas, and stats. Skip it if you need a general-purpose OpenAI-compatible proxy — the Responses-only restriction is real.

Frequently asked

What is zyycn/codex-proxy-rs?
Codex Proxy RS pools multiple Codex accounts behind one self-hosted gateway, with keys, groups, and usage tracking per client.
Is codex-proxy-rs open source?
Yes — zyycn/codex-proxy-rs is open source, released under the Apache-2.0 license.
What language is codex-proxy-rs written in?
zyycn/codex-proxy-rs is primarily written in Rust.
How popular is codex-proxy-rs?
zyycn/codex-proxy-rs has 909 stars on GitHub.
Where can I find codex-proxy-rs?
zyycn/codex-proxy-rs is on GitHub at https://github.com/zyycn/codex-proxy-rs.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.