claude-code-router — Agent Guide

No conflict-matrix pairs for this tool yet.

# Claude Code Router — Agent Guide

name: claude-code-router ｜ version_range: 3.0.22~3.0.22 ｜ generated: 2026-08-28

title_en: Claude Code Router - Local Agent Control Plane ｜ desc_en: Route across models and manage providers locally for Claude Code and other agents.

Preflight

note: Requires Node >= 22.

node --version

预期输出: see command output

Install

note: npmmirror prefix recommended in mainland China. First run requires at least one configured provider.

npm_config_registry=https://registry.npmmirror.com npm install -g @musistudio/claude-code-router --no-audit --no-fund
ccr --help

预期输出: ccr usage (start/ui/serve/stop/profile routing)

Operations

View command list

note: Verified in this environment.

ccr --help

预期输出: ccr start / ccr ui / ccr serve / ccr stop / ccr <profile> [cli|app]

Start gateway + admin UI

note: Starts a background process.

ccr start --no-open

预期输出: gateway start status; browser admin UI address (--no-open does not open the browser)

Start a specific Agent by Profile

note: Profile must be configured first.

ccr default-codex -- --model gpt-5-codex

预期输出: starts Codex with the specified profile (profile must be configured first)

Stop gateway

ccr stop

预期输出: gateway stopped

Uninstall

note: npm package + dedicated config dir auto-removed; settings.json injected section must be cleaned manually.

npm rm -g @musistudio/claude-code-router || true
rm -rf ~/.claude-code-router
command -v ccr >/dev/null 2>&1 && echo "残留: ccr 仍存在" || echo "claude-code-router removed: OK"

预期输出: claude-code-router removed: OK

Facts

writes: ~/.claude/settings.json (injected env), ~/.claude-code-router ｜ runtime: Node >= 22 ｜ notes: gateway background process (stop with ccr stop); desktop binary not tested; possible-compatible with ruflo (partially verified 2026-08-30: env fields/levels do not overlap; injection chain not fully verified)

Source: claude-code-router · validated 2026-08-28 · v3.0.22~3.0.22

← Agent index