install

Additional install commands

macOS

Homebrewverified · 100%

brew install claude-code-router

local Homebrew formula metadata

Linux

Nixverified · 92%

nix profile install nixpkgs#claude-code-router

nixpkgs package indexes · pkgs/by-name/cl/claude-code-router/package.nix · source: api.github.com

overview

Package summary

Tool to route Claude Code requests to different models and customize any request

Project links

Commands and aliases

ccr

history

Project history and usage

Claude Code Router is a local gateway for routing Claude Code and compatible agent traffic to different model providers. Its current official README describes both a CLI service and a desktop control panel that expose local gateway services and manage provider, route, credential, and profile configuration.

Project history

The npm scope `@musistudio/claude-code-router` was first published in June 2025, during the early expansion of Claude Code companion tools. The package's own description framed the project around using Claude Code with alternate LLM providers, and the README later broadened the project into a local gateway and desktop dashboard for Claude Code, Codex, ZCode, and compatible clients.

The project follows a familiar proxy pattern from developer tooling: keep the user's editor or agent workflow stable while swapping model backends behind a local endpoint. Its documented routing model includes provider presets, custom endpoints, fallback routing, request logs, profiles, plugins, and virtual models.

Adoption history

Distribution is source-backed through npm and Homebrew. The npm registry records 75 versions of `@musistudio/claude-code-router`, and Homebrew metadata records version 2.0.0 from the npm registry with Node as a dependency.

The README documents desktop downloads from GitHub Releases for macOS, Windows, and Linux AppImage, while the Homebrew formula covers the CLI-oriented install path for package-manager users.

How it is used

Users start the service with `ccr start`, then point Claude Code or another supported agent profile at the local gateway. The README documents default local services on ports 3456 and 3457, plus a web management UI on port 3458.

Its main use case is model-provider routing: default, background, thinking, long-context, image, web-search, subagent, conditional, and fallback routes can be mapped to different providers or models while credentials remain in the local router configuration.

Why package nerds care

Claude Code Router matters to package nerds because it turns an AI coding tool's network boundary into a local, configurable package. Instead of patching every client, users install one gateway and let profiles, environment, and local endpoints do the switching.

It is also a snapshot of the 2025-2026 AI CLI ecosystem: npm package, Homebrew formula, Electron-style desktop artifacts, local daemon ports, provider presets, and plugin hooks all converge around agentic coding workflows.

Timeline

2025-06: npm registry records the first `@musistudio/claude-code-router` publication.
2026: Homebrew formula `claude-code-router` packages version 2.0.0 from the npm registry.
2026: The official README documents CLI, desktop app, gateway, profile, plugin, and provider-deeplink workflows.

Related projects

Claude Code is the primary agent client the router was built around.
Codex and ZCode are named by the README as compatible clients for the local gateway profiles.
OpenRouter, DeepSeek, Gemini, Mistral, Moonshot, Kimi Code, Z.AI, Bailian, Anthropic Messages, and OpenAI-compatible APIs are named in the README as supported provider or protocol targets.
musistudio/codexl is credited in the README for Codex support and bot handoff.

Sources

security posture

Risk level: green

narrow executable package without higher-risk signals.

Risk classifier

green risk · low confidence · appliance

Why

narrow executable package without higher-risk signals

Signals

metadata:no-higher-risk-signals

Install behavior

No Homebrew post-install hook is recorded in formula metadata.
Homebrew bottle metadata is available for 1 platform targets.
Installs with 1 runtime dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

Unix: ~/.claude-code-router/config.json
Windows: %APPDATA%\Claude Code Router\config.json

Credential files

Credential-bearing paths to review before unattended agent runs.

Unix: ~/.claude-code-router/config.json
Windows: %APPDATA%\Claude Code Router\config.json

executables

Installed executables

Command	Kind	Exposure	Note
`ccr`	cli	global executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08

manager version2.0.0

manager updated2026-06-15

local dataok

upstreamnot checked

latest detectednot detected

https://musistudio.github.io/claude-code-router/

infoRelease/tag comparison is only available for GitHub repositories.https://musistudio.github.io/claude-code-router/none confidence

install metadata

Package metadata

Package key	brew:claude-code-router
Version	2.0.0
Package manager	Homebrew
Package manager page	https://formulae.brew.sh/formula/claude-code-router
Homepage	https://musistudio.github.io/claude-code-router/
Repository	https://github.com/musistudio/claude-code-router
Upstream docs	https://github.com/musistudio/claude-code-router#readme
License	MIT
Source archive	https://registry.npmjs.org/@musistudio/claude-code-router/-/claude-code-router-2.0.0.tgz
Last updated	2026-06-15T10:20:12-04:00
Pulse	updated
Dependencies	node
Bottle	available (on all)
Homebrew post-install	not defined
Service	none declared

registry facts

Source database details

Source Database	Homebrew formula API
Tap	homebrew/core
Full Name	claude-code-router
Version Scheme	0
Revision	0
Bottle Stable Root URL	https://ghcr.io/v2/homebrew/core
Deprecated	no
Disabled	no
Keg Only	no
URL Keys	stable

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Nix95%

claude-code-router

nix profile install nixpkgs#claude-code-router

normalized package name match
Matched by: Claude Code Router

nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/cl/claude-code-router/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/claude-code-router.yml

Used sources

Geiger risk classifier
Nucleus package database
av.db category and tag curation
cross-ecosystem install command graph
curated configuration and credential file locations
curated package history
external package-manager database matches
package relationship graph
package version freshness
package-page enrichment

Install claude-code-router with Homebrew, Nix