大家好,我是R哥。

Claude Code 目前非常火啊,风头盖过了 Cursor 了,但是也有几个缺点:

  • 国内网络无法直接调用,对 IP 的要求非常高;
  • 费用不便宜,订阅用户只有 20/100/200 美元/月,API 更贵,日常开发最低 100 美元/月跑不了。

最近我又发现了一款 Claude Code 低成本使用方案,那就是不使用 Claude Code 的大模型,使用 Claude Code 代理工具切换到任意大模型(比如:DeepSeek),这就成本可控了。

Claude Code Router 就是这样一款强大的 Claude Code 开源代理工具,它可以将 Claude Code 的请求路由到不同的大模型,并支持自定义任何请求。

Claude Code Router 开源地址:

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

目前已经有 12k+ Star 了。

主要功能如下:

  • 模型路由:根据您的需求将请求路由到不同的模型(比如:后台任务、思考、长上下文)。
  • 多提供商支持:支持 OpenRouter、DeepSeek、Ollama、Gemini、Volcengine 和 SiliconFlow 等各种模型提供商。
  • 请求/响应转换:使用转换器为不同的提供商自定义请求和响应。
  • 动态模型切换:在 Claude Code 中使用 /model 命令动态切换模型。
  • GitHub Actions 集成:在您的 GitHub 工作流程中触发 Claude Code 任务。
  • 插件系统:使用自定义转换器扩展功能。

安装配置教程

首先,请确保您已安装 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"
  }
}

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

主要配置项如下表:

配置项 必选 说明 示例
PROXY_URL 可选 API 请求代理地址 "http://127.0.0.1:7890"
LOG 可选 启用日志,文件位于 $HOME/.claude-code-router.log true
APIKEY 可选 API 访问密钥,需在 Authorizationx-api-key 请求头传入 "your-secret-key"
HOST 可选 服务主机地址;未设置 APIKEY 时默认强制 127.0.0.1 "0.0.0.0"
NON_INTERACTIVE_MODE 可选 非交互模式,适配 CI/CD 等自动化环境 true
Providers 可选 配置不同模型提供商
Router 可选 路由规则:
– default:常规任务默认模型
– background:后台任务模型(可用小型本地模型降成本)
– think:推理密集型任务模型
– longContext:长上下文模型(> 60K token)
– longContextThreshold(可选):触发长上下文的 token 阈值,默认 60000
– webSearch:网络搜索模型(openrouter 需加 :online 后缀)
API_TIMEOUT_MS 可选 API 请求超时时间(毫秒) 30000

使用 Router 运行 Claude Code

在某个项目下使用 ccr code 命令来启动 Claude Code,启动 Claude Code 成功后,主界面会显示代理的 API 信息:

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

ccr restart

来问问这是什么项目:

UI 模式 (Beta)

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

ccr ui

这个命令会打开一个基于 Web 的界面:

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

注意

UI 模式目前处于测试阶段,这是一个 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 代理工具,不仅提升了灵活性,又保留了 Claude Code 高效编码的优势,对于有不同的需求的人还是挺香的。

未完待续,接下来会继续分享下 AI 编程的心得体验、高级使用技巧,公众号持续分享 AI 实战干货,关注「AI技术宅」公众号和我一起学 AI。

版权声明: 本文系公众号 "AI技术宅" 原创,转载、引用本文内容请注明出处,抄袭、洗稿一律投诉侵权,后果自负,并保留追究其法律责任的权利。

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注