通过 Router 配置 Claude Code 编程助手🪜
Claude Code 是 Anthropic 推出的一款专注于强大AI Coding Agent,默认由 Claude 大模型驱动,能提供实时代码建议、代码解释与优化、多语言支持等功能,可与主流 IDE 集成,通过自然语言交互帮助开发者高效编程。
而 Claude Code Router 作为其外挂工具,主要解决了 Claude Code 原生仅支持 Claude 大模型的限制:它能将请求路由到七牛云等模型服务商的各种不同大模型上,用户可根据任务类型(如简单补全、复杂推理、长上下文处理)灵活选择适配模型,优化成本与性能平衡,还支持请求 / 响应转换、动态模型切换及 GitHub Actions 集成等,让代码辅助更灵活高效,其核心功能包括:
- 模型路由:根据需求将请求路由到不同模型(如后台任务、思考过程、长上下文处理等)
- 多提供商支持:兼容多种模型提供商的 API 接口
- 请求/响应转换:通过转换器适配不同提供商的 API 格式
- 动态模型切换:支持通过命令实时切换模型
- UI 管理界面:提供直观的 Web 界面管理配置
安装步骤
1. 安装 npm(如果尚未安装)
在开始之前,请确保您的系统已安装 Node.js 和 npm。如果尚未安装:
访问 Node.js 官网 下载对应操作系统的安装包并运行安装。
验证安装
node --version npm --version 2. 安装 Claude Code
首先安装官方的 Claude Code 工具:
npm install -g @anthropic-ai/claude-code 3. 安装 Claude Code Router
🪜
npm install -g @musistudio/claude-code-router 配置指南
1. 创建配置文件
创建并编辑配置文件 ~/.claude-code-router/config.json
{ "Providers": [ { "name": "qiniu", "api_base_url": "https://api.qnaigc.com/v1/chat/completions", "api_key": "你的七牛云大模型推理服务 apikey", "models": [ "deepseek-v3.1", "x-ai/grok-code-fast-1" ] } ], "Router": { "longContextThreshold": 60000, "default": "qiniu,deepseek-v3.1", "background": "qiniu,deepseek-v3.1", "think": "qiniu,deepseek-v3.1", "longContext": "qiniu,deepseek-v3.1", "webSearch": "qiniu,deepseek-v3.1" } } 2. 配置说明
- 基本设置:可根据需要配置代理、日志级别、超时时间等
- 七牛云配置:
name:自定义提供商标识,用于路由配置api_base_url:七牛云API地址(固定值)api_key:需替换为你的七牛云API密钥models:七牛云提供的可用模型列表
- 路由设置:
default:默认使用的模型- 其他场景可根据需求指定不同模型
使用方法
1. 启动Code
ccr code 2. 重启Code(配置修改后需要)
ccr restart 3. 使用UI管理配置
启动Web界面以便直观管理配置:
ccr ui 4. 动态切换大模型
在 Claude Code 中使用/model命令切换模型:
# 切换到七牛云的 x-ai/grok-code-fast-1 模型 /model qiniu,x-ai/grok-code-fast-1 5. 总结
至此,我们已经成功将Claude Code对接到七牛云 AI 推理服务上的其他高性价比模型,开始享受愉快的编码体验吧。
文档反馈 (如有产品使用问题,请 提交工单)