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