Skip to main content

ccr start

Start the Claude Code Router server.

Usage

ccr start [options]

Options

OptionAliasDescription
--port <number>-pPort to listen on (default: 8080)
--config <path>-cPath to configuration file
--daemon-dRun as daemon (background process)
--log-level <level>-lLog level (fatal/error/warn/info/debug/trace)

Examples

Start with default settings

ccr start

Start on custom port

ccr start --port 3000

Start with custom config

ccr start --config /path/to/config.json

Start as daemon

ccr start --daemon

Start with debug logging

ccr start --log-level debug

Environment Variables

You can also configure the server using environment variables:

VariableDescription
PORTPort to listen on
CONFIG_PATHPath to configuration file
LOG_LEVELLogging level
CUSTOM_ROUTER_PATHPath to custom router function
HOSTHost to bind to (default: 0.0.0.0)

Output

When started successfully, you'll see:

Claude Code Router is running on http://localhost:8080
API endpoint: http://localhost:8080/v1