掌中通app官方版
190.27MB · 2025-10-12
前段时间随着Claude Code CLI的爆火也随之火了一款Claude Code CLI扩展Claude Code Router，该扩展工具可以很方便的将各大主流模型接入到Claude Code CLI中使用（那段时间国内各大模型还没有支持Claude Code CLI，Claude Code CLI只能使用Claude Code模型），今天我们也来了解一下这款神奇的工具。对往期内容感兴趣的小伙伴也可以看往期内容：
claude-code-router version: 1.0.49
Claude Code Router 是一个开源工具，是 Claude Code 的扩展，旨在增强 AI 编码工作流程。它能将编码请求路由到不同的 AI 模型，为用户提供更灵活的模型交互方式。
Github地址：github.com/musistudio/…
随着Claude Code的爆火，Claude Code Router也受到越来越多小伙伴的喜爱，在Github上目前已坐拥18.3K Star。
对Claude Code Router开源项目原理感兴趣的小伙伴可以看这里：github.com/musistudio/…
Claude Code Router工作原理大致如下：
为什么需要依赖Claude Code CLI呢？通过Claude Code Router开源项目原理部分我们知道，Claude Code Router是对Claude Code CLI的逆向拦截，因此Claude Code CLI还是应用主体。对Claude Code CLI还不了解的小伙伴可以看往期内容：Claude Code CLI初体验
$ npm install -g @anthropic-ai/claude-code
安装Claude Code Router只需要在命令行终端输入如下指令：
$ npm install -g @musistudio/claude-code-router
在命令行终端执行 ccr -v 输出如下信息表示安装成功
在命令行终端输入 ccr --help 查看命令行文档
命令后参数：
Claude Code Router包含 后台服务 和 CLI 两部分，CLI的终止不影响后台服务的状态。使用【Ctrl+C】终止 ccr code 后，在命令行终端输入 ccr status 仍然可以查看Claude Code Router服务的状态
修改配置文件时需要在命令行终端输入 ccr restart 重启后台服务
不需要使用Claude Code Router时在命令行终端输入 ccr stop 终止后台服务
使用 ccr ui 可用于启动网页版配置
这是Claude Code Router原始的配置形式，为Claude Code Router提供供应商、模型等相关配置，这里先提供一份Claude Code Router完整配置文件参考：
{
"APIKEY": "your-secret-key",
"PROXY_URL": "http://127.0.0.1:7890",
"LOG": true,
"API_TIMEOUT_MS": 600000,
"NON_INTERACTIVE_MODE": false,
"Providers": [
{
"name": "openrouter",
"api_base_url": "https://openrouter.ai/api/v1/chat/completions",
"api_key": "sk-xxx",
"models": [
"google/gemini-2.5-pro-preview",
"anthropic/claude-sonnet-4",
"anthropic/claude-3.5-sonnet",
"anthropic/claude-3.7-sonnet:thinking"
],
"transformer": {
"use": ["openrouter"]
}
},
{
"name": "deepseek",
"api_base_url": "https://api.deepseek.com/chat/completions",
"api_key": "sk-xxx",
"models": ["deepseek-chat", "deepseek-reasoner"],
"transformer": {
"use": ["deepseek"],
"deepseek-chat": {
"use": ["tooluse"]
}
}
},
{
"name": "ollama",
"api_base_url": "http://localhost:11434/v1/chat/completions",
"api_key": "ollama",
"models": ["qwen2.5-coder:latest"]
},
{
"name": "gemini",
"api_base_url": "https://generativelanguage.googleapis.com/v1beta/models/",
"api_key": "sk-xxx",
"models": ["gemini-2.5-flash", "gemini-2.5-pro"],
"transformer": {
"use": ["gemini"]
}
},
{
"name": "volcengine",
"api_base_url": "https://ark.cn-beijing.volces.com/api/v3/chat/completions",
"api_key": "sk-xxx",
"models": ["deepseek-v3-250324", "deepseek-r1-250528"],
"transformer": {
"use": ["deepseek"]
}
},
{
"name": "modelscope",
"api_base_url": "https://api-inference.modelscope.cn/v1/chat/completions",
"api_key": "",
"models": ["Qwen/Qwen3-Coder-480B-A35B-Instruct", "Qwen/Qwen3-235B-A22B-Thinking-2507"],
"transformer": {
"use": [
[
"maxtoken",
{
"max_tokens": 65536
}
],
"enhancetool"
],
"Qwen/Qwen3-235B-A22B-Thinking-2507": {
"use": ["reasoning"]
}
}
},
{
"name": "dashscope",
"api_base_url": "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions",
"api_key": "",
"models": ["qwen3-coder-plus"],
"transformer": {
"use": [
[
"maxtoken",
{
"max_tokens": 65536
}
],
"enhancetool"
]
}
},
{
"name": "aihubmix",
"api_base_url": "https://aihubmix.com/v1/chat/completions",
"api_key": "sk-",
"models": [
"Z/glm-4.5",
"claude-opus-4-20250514",
"gemini-2.5-pro"
]
},
{
"name": "siliconflow",
"api_base_url": "https://api.siliconflow.cn/v1/chat/completions",
"api_key": "sk-xxx",
"models": ["moonshotai/Kimi-K2-Instruct"],
"transformer": {
"use": [
[
"maxtoken",
{
"max_tokens": 16384
}
]
]
}
}
],
"Router": {
"default": "deepseek,deepseek-chat",
"background": "ollama,qwen2.5-coder:latest",
"think": "deepseek,deepseek-reasoner",
"longContext": "openrouter,google/gemini-2.5-pro-preview",
"longContextThreshold": 60000,
"webSearch": "gemini,gemini-2.5-flash"
}
}
首次使用需要创建 ~/.claude-code-router/config.json 文件，以魔搭社区Qwen3和OpenRouter为例，配置如下内容，对魔搭社区API Key申请还不了解的小伙伴可以看往期内容：Claude Code CLI平台与中转站接入汇总及避坑
{
"Providers": [
{
"name": "modelscope",
"api_base_url": "https://api-inference.modelscope.cn/v1/chat/completions",
"api_key": "魔搭API Key",
"models": ["Qwen/Qwen3-Coder-480B-A35B-Instruct", "Qwen/Qwen3-235B-A22B-Thinking-2507"],
"transformer": {
"use": [
[
"maxtoken",
{
"max_tokens": 65536
}
],
"enhancetool"
],
"Qwen/Qwen3-235B-A22B-Thinking-2507": {
"use": ["reasoning"]
}
}
},
{
"name": "openrouter",
"api_base_url": "https://openrouter.ai/api/v1/chat/completions",
"api_key": "OpenRouter API Key",
"models": [
"deepseek/deepseek-chat-v3.1:free",
"deepseek/deepseek-r1-0528:free"
],
"transformer": {
"use": ["openrouter"]
}
}
],
"Router": {
"default": "modelscope,Qwen/Qwen3-Coder-480B-A35B-Instruct"
}
}
config.json 文件有几个关键部分：
Claude Code Router提供了可视化UI配置方式来配置 ~/.claude-code-router/config.json 文件，对配置文件形式不习惯的小伙伴也可以使用可视化交互配置形式。
在命令行终端输入 ccr ui 即可在浏览器打开Web配置界面
可以看到这里也正确展示了我们使用配置文件添加的供应商及模型配置
点击【设置】可以进行通用设置配置
点击【状态栏配置】可以设置状态栏展示效果(本人尝试没有看到效果)
点击【JOSN】可以以编辑器形式对config.json进行配置
点击【日志】可以查看日志信息
点击【添加供应商】，选择【deepseek】模版，输入【API密钥】，点击【保存】
保存成功后，即可在供应商列表查看刚刚添加的供应商信息，切换默认路由配置为【deepseek,deepseek-chat】，点击【保存并重启】保存配置文件重启Claude Code Router服务
使用 ccr code 重启Claude Code Router即可使用
在命令行终端输入 ccr code 即可启动 Claude Code Router 和 Claude Code CLI，并通过 Router 拦截并路由所有请求。
$ ccr code
启动成功后，效果如下，对Claude Code CLI还不了解的小伙伴可以看往期内容：Claude Code CLI初体验
可以看到【API Base URL】地址为本机地址：http://127.0.0.1:3456，输入提示词测试一下，看到正常回复即为配置成功
Claude Code Router提供自定义转换器功能为非官方供应商提供模型支持，这里以Gemini CLI为例对Gemini提供非官方支持， gemini-cli插件地址：gist.github.com/musistudio/…
下载文件保存到 ~/.claude-code-router/plugins/gemini-cli.js，点击【添加自定义转换器】输入转换器插件文件路径和project参数
保存成功后完整配置如下：
{
"LOG": false,
"LOG_LEVEL": "debug",
"CLAUDE_PATH": "",
"HOST": "127.0.0.1",
"PORT": 3456,
"APIKEY": "",
"API_TIMEOUT_MS": "600000",
"PROXY_URL": "",
"transformers": [
{
"name": "",
"path": "$HOME/.claude-code-router/plugins/gemini-cli.js",
"options": {
"project": "your-google-cloud-project-id"
}
}
],
"Providers": [
{
"name": "gemini",
"api_base_url": "https://cloudcode-pa.googleapis.com/v1internal",
"api_key": "gemini api key",
"models": [
"gemini-2.5-flash",
"gemini-2.5-pro"
],
"transformer": {
"use": [
"gemini-cli"
]
}
}
],
"Router": {
"default": "gemini,gemini-2.5-flash",
"background": "",
"think": "",
"longContext": "",
"longContextThreshold": 60000,
"webSearch": "",
"image": ""
},
"CUSTOM_ROUTER_PATH": ""
}
本人这里配置失败了，有需求的小伙伴可以再深入研究研究
有时通过配置文件修改了配置，配置确认无误，但是不管如何使用 ccr code 重启Claude Code CLI就是无法正常使用，遇到这种问题，我们可以尝试在命令行终端输入以下命令重启 Claude Code Router 服务
$ ccr restart
重启完成后，再次使用 ccr code 重启Claude Code Router。
Claude Code Router提供了整合多模型共同高效完成任务的能力，同时提供灵活的配置方式，告别单一模型的局限性和高昂的成本，但是与此同时也带来了一定的问题，多模型整合意味着无法详细计算tokens消耗，无法知晓都使用了哪些模型，再加上目前工具尚有一些bug，我们还是需要根据自己的情况酌情使用。随着目前各大供应商陆续支持Claude Code CLI，在Claude Code CLI中使用不同模型也不再是限制问题，只需在在命令行终端配置Base URL和API Key即可，甚至比Claude Code Router配置更简单，所以对于使用单模型的小伙伴来说使用Claude Code Router就显得没有必要了。
见原文：使用Claude Code Router轻松切换各种高性价比模型
