安装

其他安装命令

macOS

Homebrew已验证 · 100%

brew install claude-code-router

local Homebrew formula metadata

Linux

Nix已验证 · 92%

nix profile install nixpkgs#claude-code-router

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

概览

软件包摘要

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

项目链接

命令和别名

ccr

历史

项目历史与用法

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.

项目历史

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.

采用历史

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.

使用方式

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.

为什么软件包爱好者会关心

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.

时间线

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.

来源

安全态势

风险级别：绿色

narrow executable package without higher-risk signals.

风险分类器

绿色风险 · 低置信度 · appliance

原因

narrow executable package without higher-risk signals

信号

metadata:no-higher-risk-signals

安装行为

formula 元数据中未记录 Homebrew post-install 钩子。
Homebrew bottle 元数据适用于 6 个平台目标。
安装时包含 1 个运行时依赖。

建议审查

在无人值守的代理使用前，请检查该工具是否读取明文凭据、写入远程状态、发布制品或调用插件。

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

可执行文件

已安装的可执行文件

命令	类型	暴露范围	备注
`ccr`	cli	全局可执行文件

新鲜度

版本和新鲜度

这些信号区分页生成时间、软件包管理器活动和上游发布比较。只有存在证据 URL 和可比较版本时，才会提示版本落后。

页面生成时间2026-07-25

管理器版本3.0.7

管理器更新时间2026-07-21

本地数据OK

上游not checked

信息Release/tag comparison is only available for GitHub repositories.https://musistudio.github.io/claude-code-router/none 置信度

安装元数据

软件包元数据

软件包键	brew:claude-code-router
版本	3.0.7
软件包管理器	Homebrew
软件包管理器页面	https://formulae.brew.sh/formula/claude-code-router
主页	https://musistudio.github.io/claude-code-router/
仓库	https://github.com/musistudio/claude-code-router
上游文档	https://github.com/musistudio/claude-code-router#readme
许可证	MIT
源码归档	https://registry.npmjs.org/@musistudio/claude-code-router/-/claude-code-router-3.0.7.tgz
最后更新	2026-07-21T19:01:15Z
Pulse	updated
依赖	node
Bottle	可用 (于 arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-install	未定义
服务	未声明

注册表事实

源数据库详情

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

源数据库匹配

其他软件包管理器记录

匹配项来自外部软件包管理器索引，并与本地 Automic Vault 软件包链接分开显示。

Nix95%

claude-code-router

nix profile install nixpkgs#claude-code-router

normalized package name match
匹配方式：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

软件包图谱

链接来自本地软件包关系图、补充数据、依赖边、生态匹配和软件包 hub 归属。

来源线索

由仓库数据生成

此页面由 av-web 从 scripts/generate-pkg-sqlite.py 生成的私有软件包 SQLite 工件提供。

Combined YAML source

View the package source record on GitHub.

combined/claude-code-router.yml

使用的来源

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

使用 Homebrew, Nix 安装 claude-code-router