Claude Code Router不仅仅是一个工具,更是一种开发理念的革新。它让AI助手的使用变得更加开放和便捷,让每个开发者都能享受到多模型带来的便利。通过简单的配置,你就能拥有一个功能强大、灵活可扩展的AI开发环境。

clawdbot爆火,但是需要了解这三点:

第一:所谓”开源免费”实则是软件免费,真正烧钱的是API调用,且记忆功能会让成本随时间累积。

第二:便宜模型难以支撑复杂任务,代码错误多、响应慢,省下的API费可能抵不上时间成本。

第三:本质是大模型API+电脑控制脚本,许多博主贩卖的是FOMO焦虑而非实用工具。

个人觉得还是要冷静一下,与其天天追热点,囤工具,付订阅,你不如先搞清楚一个问题,你到底要要用AI解决什么具体的问题,如果你连这个都没有想明白,注册再多的工具,买再多API,实际上就是为了博主的流量跟大厂的财报打工而已,毕竟道路千万条,安全第一条。

核心痛点:为什么需要Claude Code Router?

还在为Claude Code的高门槛烦恼?想要体验多模型切换的便利却受限于账号限制?Claude Code Router正是你需要的解决方案。这个开源工具让你无需Anthropic官方账号,就能将Claude Code请求智能路由到DeepSeek、OpenRouter、Kimi等主流LLM提供商,实现真正的模型自由。

账号限制问题:Claude Code原本需要绑定Anthropic账号,这对很多开发者来说是个不小的门槛。Claude Code Router通过智能路由机制,完美解决了这一痛点。

多模型管理混乱:当项目需要同时使用多个AI模型时,配置复杂、切换繁琐成为常态。这个工具提供统一的管理界面,让模型切换变得简单直观。

项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-router

解决方案:三大核心功能模块

智能路由配置

Claude Code Router支持灵活的模型路由策略,你可以根据需求设置默认路由模型、背景模型和思考链模型。通过简单的界面操作,就能实现不同场景下的模型自动切换。

状态栏实时监控

项目的StatusLine功能让你随时掌握工作状态,包括当前工作目录、Git分支、使用的模型类型以及Token消耗情况。所有信息一目了然,无需频繁切换窗口。

自定义转换器支持

除了内置的模型提供商,Claude Code Router还支持自定义转换器插件。这意味着你可以根据自己的需求扩展功能,实现更加个性化的AI助手体验。

快速部署上手配置指南

环境准备

安装 nvm(Node.js 版本管理器,核心工具)

nvm 是管理 Node.js 版本的最佳工具,能解决系统库版本兼容问题,步骤如下:

下载并安装nvm(国内源加速版,避免网络超时)

curl -o- https://gitee.com/mirrors/nvm/raw/v0.39.7/install.sh | bash  
# 若curl未安装,先执行:yum install -y curl(CentOS) / apt install -y curl(Ubuntu)
  • 1.
  • 2.

关键:刷新环境变量(让 nvm 生效)

安装完成后,执行以下命令加载 nvm:

source ~/.bashrc
  • 1.

若用 zsh 终端,执行:source ~/.zshrc

验证 nvm 是否安装成功:

nvm --version(输出版本号如 v0.39.7 则成功)

安装 Node.js

nvm install node

若想指定具体版本(如20.21.3)nvm install 22

设置默认 Node.js 版本(每次终端启动自动生效)nvm alias default 22

验证安装成功执行以下命令,无报错且输出版本号则成功:

查看Node.js版本node -v  # 输出:v22.21.3(或其他22.x版本)

查看npm版本(Node.js自带)npm -v

首先,请确保您已安装 Claude Code:

npm install -g @anthropic-ai/claude-code

然后,安装 Claude Code Router

npm install -g @musistudio/claude-code-router

这安装真的超简单,不需要手动安装一些乱七八糟的依赖组件。

安装后,创建并配置你的 ~/.claude-code-router/config.json 文件,也可以前端界面配置:

{
  "LOG": false,
"HOST": "0.0.0.0",
"API_TIMEOUT_MS": 600000,
"Providers": [
    {
      "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": "gemini",
      "api_base_url": "https://generativelanguage.googleapis.com/v1beta/models/",
      "api_key": "xx",
      "models": ["gemini-2.5-flash", "gemini-2.5-pro"],
      "transformer": {
        "use": ["gemini"]
      }
    }
  ],
"Router": {
    "default": "deepseek,deepseek-chat",
    "background": "deepseek,deepseek-chat",
    "think": "deepseek,deepseek-reasoner",
    "longContext": "gemini,gemini-2.5-pro",
    "longContextThreshold": 60000,
    "webSearch": "gemini,gemini-2.5-flash"
  }
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.
  • 32.
  • 33.
  • 34.
  • 35.
  • 36.

Claude Code Router 可以配置市面上任意大模型,包括 Ollama 本地运行的大模型。以上仅供参考,仅配置了 deepseek、gemini,对应的 api_key 请换成自己的。

主要配置项如下表:

路由规则:

  • default:常规任务默认模型
  • background:后台任务模型(可用小型本地模型降成本)
  • think:推理密集型任务模型
  • longContext:长上下文模型(> 60K token)
  • longContextThreshold(可选):触发长上下文的 token 阈值,默认 60000
  • webSearch:网络搜索模型(openrouter 需加 :online 后缀)

使用 Router 运行 Claude Code

ccr code

注意: 修改配置文件后,需要重启服务使配置生效:

ccr restart

浏览器访问和添加管理模型

为了获得更直观的体验,可以使用 UI 模式来管理配置,命令如下:http://xxxx:3456/ui

图片

我们可以在 Web 页面中轻松查看和编辑 config.json 配置文件,界面化添加和管理模型,配置起来非常方便快捷。

注意:这是一个 100% vibe coding 的项目,包括项目的初始化,只是新建了一个文件夹和一个 project.md 文档。所有代码均由 ccr + qwen3-coder + gemini(webSearch) 实现。

总结

Claude Code 本身体验极好,但受限于昂贵的订阅费用和网络环境,想要长期使用成本并不低。

而 Claude Code Router 提供了一种更灵活、低成本的替代方案:保留 Claude Code 的使用习惯,同时自由接入任意大模型提供商,实现模型的路由、切换与请求适配,大大提升了自由度与可控性。

通过简单配置,你可以:

  • 接入 DeepSeek、Gemini、Ollama 等多个模型平台;
  • 针对不同任务分发不同模型,提升效率与响应质量;
  • 使用本地或国产模型完成大部分需求,显著降低 API 成本;
  • 借助 UI 界面,可以方便便捷地管理模型与配置项;
  • 在不改动 Claude Code 原始使用方式的基础上,获得更强模型能力;

总结:为什么选择Claude Code Router

Claude Code Router不仅仅是一个工具,更是一种开发理念的革新。它让AI助手的使用变得更加开放和便捷,让每个开发者都能享受到多模型带来的便利。通过简单的配置,你就能拥有一个功能强大、灵活可扩展的AI开发环境。

文章来自:51CTO

Loading

作者 yinhua

发表回复