关注公众号,AI 技术干货及时送达_↓_

推荐阅读:玩转 Claude Code 的 23 个实用小技巧


大家好,我是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 文件:

<span data-cacheurl="" data-remoteid="" data-lazy-bgimg="https://mmbiz.qpic.cn/mmbiz_svg/5K48YNcpF3bf3RicmjPNbKCtzZLKLTmRkE9P2OPvON4egH1FaalziaHHtlJED8IQKKpuCXbdV7xCImpejmoglbHia4ibZY2Erd4ic/640?wx_fmt=svg&amp;from=appmsg" data-fail="0"><span leaf="">{<span leaf="">  
<span leaf="">  <span leaf="">"LOG"<span leaf="">: <span leaf="">false<span leaf="">,<span leaf="">  
<span leaf="">"HOST"<span leaf="">: <span leaf="">"0.0.0.0"<span leaf="">,<span leaf="">  
<span leaf="">"API_TIMEOUT_MS"<span leaf="">: <span leaf="">600000<span leaf="">,<span leaf="">  
<span leaf="">"Providers"<span leaf="">: [<span leaf="">  
<span leaf="">    {<span leaf="">  
<span leaf="">      <span leaf="">"name"<span leaf="">: <span leaf="">"deepseek"<span leaf="">,<span leaf="">  
<span leaf="">      <span leaf="">"api_base_url"<span leaf="">: <span leaf="">"https://api.deepseek.com/chat/completions"<span leaf="">,<span leaf="">  
<span leaf="">      <span leaf="">"api_key"<span leaf="">: <span leaf="">"sk-xxx"<span leaf="">,<span leaf="">  
<span leaf="">      <span leaf="">"models"<span leaf="">: [<span leaf="">"deepseek-chat"<span leaf="">, <span leaf="">"deepseek-reasoner"<span leaf="">],<span leaf="">  
<span leaf="">      <span leaf="">"transformer"<span leaf="">: {<span leaf="">  
<span leaf="">        <span leaf="">"use"<span leaf="">: [<span leaf="">"deepseek"<span leaf="">],<span leaf="">  
<span leaf="">        <span leaf="">"deepseek-chat"<span leaf="">: {<span leaf="">  
<span leaf="">          <span leaf="">"use"<span leaf="">: [<span leaf="">"tooluse"<span leaf="">]<span leaf="">  
<span leaf="">        }<span leaf="">  
<span leaf="">      }<span leaf="">  
<span leaf="">    },<span leaf="">  
<span leaf="">    {<span leaf="">  
<span leaf="">      <span leaf="">"name"<span leaf="">: <span leaf="">"gemini"<span leaf="">,<span leaf="">  
<span leaf="">      <span leaf="">"api_base_url"<span leaf="">: <span leaf="">"https://generativelanguage.googleapis.com/v1beta/models/"<span leaf="">,<span leaf="">  
<span leaf="">      <span leaf="">"api_key"<span leaf="">: <span leaf="">"xx"<span leaf="">,<span leaf="">  
<span leaf="">      <span leaf="">"models"<span leaf="">: [<span leaf="">"gemini-2.5-flash"<span leaf="">, <span leaf="">"gemini-2.5-pro"<span leaf="">],<span leaf="">  
<span leaf="">      <span leaf="">"transformer"<span leaf="">: {<span leaf="">  
<span leaf="">        <span leaf="">"use"<span leaf="">: [<span leaf="">"gemini"<span leaf="">]<span leaf="">  
<span leaf="">      }<span leaf="">  
<span leaf="">    }<span leaf="">  
<span leaf="">  ],<span leaf="">  
<span leaf="">"Router"<span leaf="">: {<span leaf="">  
<span leaf="">    <span leaf="">"default"<span leaf="">: <span leaf="">"deepseek,deepseek-chat"<span leaf="">,<span leaf="">  
<span leaf="">    <span leaf="">"background"<span leaf="">: <span leaf="">"deepseek,deepseek-chat"<span leaf="">,<span leaf="">  
<span leaf="">    <span leaf="">"think"<span leaf="">: <span leaf="">"deepseek,deepseek-reasoner"<span leaf="">,<span leaf="">  
<span leaf="">    <span leaf="">"longContext"<span leaf="">: <span leaf="">"gemini,gemini-2.5-pro"<span leaf="">,<span leaf="">  
<span leaf="">    <span leaf="">"longContextThreshold"<span leaf="">: <span leaf="">60000<span leaf="">,<span leaf="">  
<span leaf="">    <span leaf="">"webSearch"<span leaf="">: <span leaf="">"gemini,gemini-2.5-flash"<span leaf="">  
<span leaf="">  }<span leaf="">  
<span leaf="">}<span leaf="">  

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 访问密钥,需在 Authorization 或 x-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技术宅” 原创,转载、引用本文内容请注明出处,抄袭、洗稿一律投诉侵权,后果自负,并保留追究其法律责任的权利。

< END >

推荐阅读:

再见 Cursor,Kiro 横空出世!

用了 Claude Code,发现 Cursor 是弱智

玩转 Claude Code 的 23 个实用小技巧

榨干 Claude Code 的 16 个实用小技巧

年度爆款!全球最火的 AI 编程工具合集

MCP 是什么?如何使用?一文讲清楚!

从零开始开发一个 MCP Server!

62 个 DeepSeek 万能提示词(建议收藏)

33k+ star!全网精选的 MCP 一网打尽!

更多 ↓↓↓ 关注公众号 ✔ 标星⭐ 哦