# Install claude-code-router with Homebrew, Nix Tool to route Claude Code requests to different models and customize any request. Version 2.0.0 via Homebrew; verified 2026-06-15. ## Install ```sh sudo av install brew:claude-code-router ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install claude-code-router ``` Evidence: local Homebrew formula metadata ### Linux - Nix (92%): ```sh nix profile install nixpkgs#claude-code-router ``` Evidence: 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 facts - **Package key:** brew:claude-code-router - **Package manager:** Homebrew - **Package manager page:** - **Version:** 2.0.0 - **Source summary:** Tool to route Claude Code requests to different models and customize any request - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-06-15T10:20:12-04:00 - **Generated:** 2026-07-09T07:20:21+00:00 ## Executables - ccr (cli) - ccr (alias) ## Dependencies - node ## Install behavior - Post-install hook: not defined - Bottle: available on all ## Freshness - Page generated: 2026-07-09 - Package-manager version: 2.0.0 - Package-manager updated: 2026-06-15 - Local data: ok - Upstream repository: https://musistudio.github.io/claude-code-router/ - info: Release/tag comparison is only available for GitHub repositories. ## 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 Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## 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 - Unix: ~/.claude-code-router/config.json - Windows: %APPDATA%\Claude Code Router\config.json ## Credential files - Unix: ~/.claude-code-router/config.json - Windows: %APPDATA%\Claude Code Router\config.json ## 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:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - Nix - claude-code-router: normalized package name match | 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 ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [node](https://www.automicvault.com/pkg/brew/node/) - Runtime dependency declared by Homebrew. - [claude-cmd](https://www.automicvault.com/pkg/brew/claude-cmd/) - Shares av.db curated category or tags: ai-coding, claude-code, cli, developer-tools. - [claude-code-templates](https://www.automicvault.com/pkg/brew/claude-code-templates/) - Shares av.db curated category or tags: ai-coding, claude-code, cli, developer-tools. - [claude-hooks](https://www.automicvault.com/pkg/brew/claude-hooks/) - Shares av.db curated category or tags: ai-coding, claude-code, cli, developer-tools. - [claude-squad](https://www.automicvault.com/pkg/brew/claude-squad/) - Shares av.db curated category or tags: ai-coding, claude-code, cli, developer-tools. - [claudekit](https://www.automicvault.com/pkg/brew/claudekit/) - Shares av.db curated category or tags: ai-coding, claude-code, cli, developer-tools. - [cline](https://www.automicvault.com/pkg/brew/cline/) - Shares av.db curated category or tags: ai-coding, cli, developer-tools. - [codex-acp](https://www.automicvault.com/pkg/brew/codex-acp/) - Shares av.db curated category or tags: ai-coding, cli, developer-tools. - [gemini-cli](https://www.automicvault.com/pkg/brew/gemini-cli/) - Shares av.db curated category or tags: ai-coding, cli, developer-tools. ## Combined YAML source View the package source record on GitHub. [combined/claude-code-router.yml](https://github.com/automic-vault/db/blob/main/combined/claude-code-router.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph