Skip to main content

Quick Start

Get up and running with Claude Code Router in 5 minutes.

1. Start the Router​

From the repository root, start the service:

cd packages/server
docker compose up --build -d

The router will start on http://localhost:3456.

2. Configure the Router​

Before using Claude Code Router, you need to configure your LLM providers. Edit the configuration mounted into the container at packages/server/ccr-config/config.json:

{
  "HOST": "0.0.0.0",
  "PORT": 3456,
  "Providers": [
    {
      "name": "my-provider",
      "baseUrl": "https://api.example.com/v1",
      "apiKey": "$YOUR_API_KEY",
      "models": ["model-name"]
    }
  ],
  "Router": {
    "default": "my-provider,model-name"
  }
}

After editing the config, restart the service:

docker compose restart ccr

You can also use the Web UI at http://localhost:3456/ui/ to configure providers visually.

3. Use Claude Code​

Now you can use Claude Code with your configured provider. Set the required environment variables and run Claude Code directly:

export ANTHROPIC_BASE_URL="http://localhost:3456/v1"
export ANTHROPIC_API_KEY="dummy"
claude

Your requests will be routed through Claude Code Router to your configured provider.

Restart After Configuration Changes​

If you modify the configuration file or make changes through the Web UI, restart the service:

docker compose restart ccr

What's Next?​