cliproxy-rs

One local endpoint so Codex CLI, Claude Code and other tools can use DeepSeek, GLM, Kimi, OpenRouter or your own gateway, with your API keys or your own accounts. You can mix providers and translate between the OpenAI, Anthropic and Gemini APIs.

Quick start

1. On macOS or Linux:

   curl -fsSL https://raw.githubusercontent.com/vayungodara/cliproxy-rs/master/install.sh | sh
   

   On Windows, in PowerShell:

   irm https://raw.githubusercontent.com/vayungodara/cliproxy-rs/master/install.ps1 | iex
   

   The installer checks the release checksum, writes ~/.cliproxy-rs/config.yaml, starts the proxy and opens the dashboard. On Windows, the config is %USERPROFILE%\.cliproxy-rs\config.yaml. It saves new keys in keys.env without printing them.

   On Windows you can also use Scoop. It installs the binary only, so create the config and keys as in First run without the install script:

   scoop bucket add vayungodara https://github.com/vayungodara/scoop-bucket
   scoop install vayungodara/cliproxy-rs
   

   Or, on macOS or Linux, with Homebrew:

   brew install vayungodara/tap/cliproxy-rs
   brew services start cliproxy-rs
   

   Its config and keys.env live in $(brew --prefix)/etc/cliproxy-rs/, and the dashboard is at http://127.0.0.1:8317/management.html. See Homebrew.

2. Sign in to the dashboard with CLIPROXY_MANAGEMENT_KEY from the keys.env next to your config. Connect your own account or add a provider API key. Read Accounts and provider terms before connecting a subscription.

3. Open the dashboard's Use with tools page and copy the Codex CLI or Claude Code settings. Your tools use CLIPROXY_CLIENT_KEY, not the management key.

Run the install command again to upgrade, or brew upgrade cliproxy-rs with Homebrew. Both keep your config and keys. INSTALL.md covers start at login, release binaries, Docker and building from source. GETTING-STARTED.md has the longer walkthrough.

What is this?

cliproxy-rs is a Rust rewrite of CLIProxyAPI. It reads the same config.yaml and credential formats and implements the client routes and v8 Management API. Parity is incomplete: the audit has 1,687 items, with 835 covered, 707 partial and 145 missing. PARITY.md defines those counts.

The dashboard shows accounts, provider limits, request history and tool settings.

Watch the launch film

Use it with your tools

The local OpenAI base URL is http://127.0.0.1:8317/v1. Claude Code and Gemini clients use http://127.0.0.1:8317 without /v1. Use your installation's port and client key.

CLIENTS.md has client settings, including GPT in Claude Code. Not every model and tool combination has been tested.

API keys: Codex CLI and mixed providers

Codex CLI only speaks the Responses API now. A provider entry with wire_api = "chat" stops Codex with "wire_api = "chat" is no longer supported".