claude-code-smart-router (ccsr)

Intelligent tier routing for claude-code-router. Classifies each request and picks the cheapest tier (simple / medium / complex) that can handle it well, across any provider CCR supports, while respecting live quota usage.

Install

npm i claude-code-smart-router

Configure CCR to use it

In your CCR config (~/.claude-code-router/config.json):

{
  "CUSTOM_ROUTER_PATH": "/absolute/path/to/node_modules/claude-code-smart-router/src/index.js"
}

Configure ccsr

Create ~/.claude-code-smart-router/config.json:

{
  "enabled": true,
  "fallbackBehavior": "downgrade",
  "userDefaultModel": "anthropic,claude-sonnet-4-6",
  "tiers": {
    "simple":  { "provider": "anthropic", "model": "claude-haiku-4-5",   "protocol": "anthropic", "maxPercentOfQuota": 80 },
    "medium":  { "provider": "anthropic", "model": "claude-sonnet-4-6",  "protocol": "anthropic", "maxPercentOfQuota": 80 },
    "complex": { "provider": "anthropic", "model": "claude-opus-4-7",    "protocol": "anthropic", "maxPercentOfQuota": 80 }
  },
  "classifier": {
    "provider": "anthropic",
    "model": "claude-haiku-4-5",
    "protocol": "anthropic"
  }
}

All fields are optional — see defaults.

Providers

ccsr is provider-agnostic. Supported providers (via CCR):

• openrouter
• anthropic
• deepseek
• gemini
• groq
• openai
• ollama

ccsr reuses credentials from CCR's Providers[] config automatically — you don't need a separate API key unless you want to override the classifier's credentials via classifier.apiKey.

Mix-and-match per tier, e.g. simple on groq, medium on anthropic, complex on openrouter.

CLI

• ccsr on / ccsr off — toggle routing (off = pass-through to userDefaultModel).
• ccsr status — current config.
• ccsr stats — tier distribution, cache hit rate, avg latency.
• ccsr tail — live decision stream.
• ccsr set fallback downgrade|userDefault — change behavior when a tier hits its quota cap.

How it works

See docs/specs/2026-04-18-ccsr-design.md.

License

MIT.