Command reference

Running claude-code-proxy without a subcommand is equivalent to claude-code-proxy serve.

Global version commands

claude-code-proxy --version
claude-code-proxy -v
claude-code-proxy version

Each prints claude-code-proxy <version>.

`serve`

claude-code-proxy serve [--port <PORT>] [--no-monitor]

Starts the local HTTP proxy and blocks until shutdown.

Option	Behavior
`--port <PORT>`	Overrides `PORT`, `config.json`, and the default for this invocation.
`--no-monitor`	Uses plain output even when stdout is a terminal.

The bind address comes from CCP_BIND_ADDRESS or bindAddress. Interactive stdout opens the monitor unless --no-monitor is present. Non-terminal stdout uses plain mode.

`demo`

claude-code-proxy demo

Opens the monitor with deterministic simulated traffic. It does not bind a network port or contact providers.

`models`

claude-code-proxy models [--full]

Prints supported IDs grouped by provider. The default output compacts Cursor’s runtime catalog. --full prints every Cursor alias.

Provider authentication

The command shape is:

claude-code-proxy <provider> auth <action>

Provider	`login`	`device`	`status`	`logout`
`codex`	Browser PKCE	Device code	Account, expiry, storage	Delete proxy credential
`kimi`	Device code	Unsupported	User, expiry, scope, storage	Delete proxy credential
`grok`	Browser PKCE	Device code	Expiry and storage	Delete proxy credential
`cursor`	Browser polling flow	Unsupported	Source, claims, expiry	Delete proxy credential

Examples:

claude-code-proxy codex auth login
claude-code-proxy grok auth device
claude-code-proxy kimi auth status
claude-code-proxy cursor auth logout

A missing credential makes auth status exit with status 1. Other provider command failures exit with status 2. Successful commands exit with status 0.

Logout removes the local proxy-owned credential. It does not call the provider to revoke a refresh token.

Development commands

From a source checkout:

cargo run -- serve
cargo test --all
cargo fmt --all --check
cargo clippy --all-targets -- -D warnings
just check
just docs

just docs installs the locked documentation dependencies and starts the Astro development server on an available local port.