什么是 Claude Code Router?
Claude Code Router 是一个开源代理网关,位于 Claude Code 和任何 LLM 提供商之间。 它绑定到本地端口(通常是 127.0.0.1:3456),让您可以将不同类型的 Claude Code 请求路由到不同的模型 - 一些任务使用 Claude,另一些任务使用 DeepSeek 或 Gemini,本地 Ollama 用于低成本操作。
结果是:API 成本更低,没有单一供应商锁定,并且按任务类型进行智能路由。 当您将 Claude Code Router 与 AI Perks 提供的价值 $1,500-$75,000+ 的免费 Anthropic 和 OpenAI 积分搭配使用时,您就可以零成本地获得每个提供商的最佳服务。
在AI积分上节省您的预算
| Software | 预估积分 | 审批指数 | 操作 | |
|---|---|---|---|---|
推广您的 SaaS
覆盖全球 90,000+ 寻找类似您工具的创始人
为什么要使用 Claude Code Router
Claude Code 默认会将每个请求发送到 Anthropic 的 Claude API。如果您拥有无限的 Claude 预算,这没问题 - 但在 2026 年,有三个原因使得多模型路由器变得有吸引力:
| 原因 | 无路由器 | 带路由器 |
|---|---|---|
| 成本优化 | 所有任务都使用 Sonnet 4.6 ($3/$15) | 低成本任务 → DeepSeek ($0.14/$0.28) |
| 避免速率限制 | 达到 Anthropic 的限制 → 被阻止 | 自动故障转移到其他提供商 |
| 特定于提供商的优势 | 仅限 Claude | 使用 Gemini 处理视觉,GPT 处理代码等。 |
| 隐私/本地执行 | 仅限云端 | 将敏感任务路由到本地 Ollama |
对于运行大量 Claude Code 工作负载的开发人员来说,Claude Code Router 的 API 成本可以节省 50-99%,具体取决于路由策略。
Claude Code Router 支持的提供商
| 提供商 | 优势 | 定价层 |
|---|---|---|
| Anthropic (默认) | 最佳编码质量 | 高级 |
| OpenRouter | 200+ 模型,单一 API | 可变 |
| DeepSeek | 低成本推理 (R1, V3) | 超低成本 |
| Gemini | 长上下文,视觉 | 免费套餐 + 低成本付费 |
| Ollama | 本地,私有,免费 | $0 (您的硬件) |
| OpenAI (GPT-5, GPT-4.1) | 强大的通用能力 | 高级 |
| VolcEngine / SiliconFlow | 快速的中文提供商 | 低成本 |
| DashScope (Alibaba Qwen) | 强大的开源模型 | 低成本 |
| ModelScope | 开源模型托管 | 可变 |
多提供商路由是杀手级功能。 单个 Claude Code 会话可以根据路由规则透明地使用 3-5 个不同的提供商。
如何安装 Claude Code Router
先决条件
- 已安装 Claude Code (
npm install -g @anthropic-ai/claude-code@latest) - Node.js 18 或更高版本
- 至少一个非 Anthropic 提供商的 API 密钥(或已运行本地 Ollama)
通过 npm 安装
npm install -g @musistudio/claude-code-router
或通过 GitHub
git clone https://github.com/musistudio/claude-code-router
cd claude-code-router
npm install
npm run build
配置 Claude Code Router
路由器使用 ~/.claude-code-router/config.json 处的 JSON 配置文件:
{
"Providers": [
{
"name": "anthropic",
"api_key": "sk-ant-...",
"api_base": "https://api.anthropic.com"
},
{
"name": "deepseek",
"api_key": "sk-deepseek-...",
"api_base": "https://api.deepseek.com"
},
{
"name": "openrouter",
"api_key": "sk-or-...",
"api_base": "https://openrouter.ai/api/v1"
}
],
"Router": {
"default": "anthropic,claude-sonnet-4-6",
"background": "deepseek,deepseek-chat",
"reasoning": "deepseek,deepseek-r1",
"longContext": "gemini,gemini-2.5-pro"
}
}
每个路由类别做什么
| 类别 | 何时使用 | 推荐模型 |
|---|---|---|
default | 标准提示 | Claude Sonnet 4.6 (质量) |
background | 自动任务,摘要 | DeepSeek Chat (低成本) |
reasoning | 复杂问题解决 | DeepSeek R1 或 Claude Opus |
longContext | 大型代码库 | Gemini 2.5 Pro (100 万上下文) |
您可以基于 token 数量、任务类型或您用 JavaScript 编写的任何逻辑添加自定义路由规则。
启动 Claude Code Router
运行路由器服务:
ccr start
然后配置 Claude Code 使用路由器:
export ANTHROPIC_BASE_URL="http://127.0.0.1:3456"
claude
现在每个 Claude Code 请求都将通过路由器,并根据您的配置路由到相应的提供商。
Claude Code Router 的成本节省
实际的路由策略可能会这样分配流量:
| 任务类型 | 流量百分比 | 提供商 | 每 100 万 token 的成本 |
|---|---|---|---|
| 默认编码 | 40% | Claude Sonnet 4.6 | $3 / $15 |
| 后台任务 | 30% | DeepSeek Chat | $0.14 / $0.28 |
| 长上下文读取 | 20% | Gemini 2.5 Pro | $1.25 / $5 |
| 本地隐私 | 10% | Ollama (本地) | $0 |
每月成本比较 (重度用户,每月 1 亿 token)
| 设置 | 每月成本 | 对比仅使用 Anthropic |
|---|---|---|
| 全部使用 Claude Sonnet 4.6 | $1,500 - $1,800 | 基线 |
| 智能路由 (上方) | $300 - $500 | 节省 70-80% |
| 路由器 + 免费积分 | $0 - $50 | 节省 97-100% |
结合通过 AI Perks 获得的免费积分,路由器可以将您的实际成本降至接近零。
路由规则示例
按 Token 数量路由
"Router": {
"default": "anthropic,claude-sonnet-4-6",
"longContext": "gemini,gemini-2.5-pro",
"tokenThreshold": 50000
}
当请求超过 50,000 个输入 token 时,它将路由到 Gemini 的一百万 token 上下文窗口,而不是 Claude。
按任务类型路由
"Router": {
"default": "anthropic,claude-sonnet-4-6",
"background": "deepseek,deepseek-chat",
"vision": "gemini,gemini-2.5-pro"
}
后台任务将路由到低成本的 DeepSeek,视觉任务路由到 Gemini,普通任务则保留在 Claude 上。
将敏感代码路由到本地 Ollama
"Router": {
"default": "anthropic,claude-sonnet-4-6",
"private": "ollama,llama-3.3-70b"
}
使用元数据标记敏感提示,将其路由到本地 Ollama,避免任何云传输。
Claude Code Router + 免费积分:终极设置
路由器本身可以降低成本。将其与免费积分结合,成本将降至零,同时在关键领域保持 Claude 的质量。
驱动路由器的免费积分计划
| 积分来源 | 可用积分 | 用于 |
|---|---|---|
| Anthropic Claude (直接) | $1,000 - $25,000 | 默认 + 推理路由 |
| OpenAI (GPT-5, GPT-4.1) | $500 - $50,000 | 替代编码路由 |
| Google Cloud Vertex (Gemini) | $1,000 - $25,000 | 长上下文路由 |
| AWS Activate (Bedrock - Claude) | $1,000 - $100,000 | 备用 Claude 访问 |
| Microsoft Founders Hub | $500 - $1,000 | Azure OpenAI 访问 |
总计潜在:所有提供商总计 $4,000 - $201,000+ 的免费积分
AI Perks 涵盖了所有计划,因此您的 Claude Code Router 可以利用多个免费积分来源。
分步:设置路由器 + 免费积分
步骤 1:获取跨提供商的免费积分
订阅 AI Perks 并申请价值最高的 Anthropic、OpenAI 和 Google Cloud 积分计划。
步骤 2:安装 Claude Code Router
npm install -g @musistudio/claude-code-router
步骤 3:配置多提供商路由
使用每个提供商的 API 密钥编辑 ~/.claude-code-router/config.json(所有都由免费积分提供支持)。
步骤 4:启动路由器
ccr start
步骤 5:将 Claude Code 指向路由器
export ANTHROPIC_BASE_URL="http://127.0.0.1:3456"
claude
步骤 6:监控和优化
查看哪些路由消耗的积分最多。调整路由规则以最大化免费积分的使用并最小化付费支出。
常见问题解答
Claude Code Router 是免费的吗?
是的,Claude Code Router 是开源的,安装免费。 您只需为它路由的底层 API 提供商付费。通过 AI Perks 获得的免费积分,整个设置可以在数月或数年内以 $0 的 API 成本运行。
Claude Code Router 是否与 Anthropic 的官方 Claude Code 一起使用?
是的。 Claude Code Router 通过将 ANTHROPIC_BASE_URL 设置为路由器的本地地址,来拦截官方 Claude Code CLI 的请求。然后,路由器会将请求转发到您为该任务类型配置的提供商。
Claude Code Router 与 LiteLLM 有何区别?
Claude Code Router 是专为 Claude Code 构建的,具有任务感知路由。 LiteLLM 是一个更通用的 LLM 网关,适用于任何客户端。两者都可以服务于相似的目的;Claude Code Router 与 Claude Code 的特定请求模式集成更紧密。
我可以使用 Claude Code Router 处理隐私敏感的代码吗?
是的。 配置路由规则,将敏感提示发送到本地 Ollama 或自托管模型。公共/非敏感提示路由到云提供商。这使您能够在不将私有代码暴露给外部 API 的情况下,获得 Claude 级别的编码辅助。
Claude Code Router 能为我节省多少钱?
典型的节省幅度为 API 成本的 50-99%,具体取决于您的路由策略。将后台任务路由到 DeepSeek(比 Claude Opus 便宜约 50 倍)是最大的成本节约项。结合 AI Perks 提供的免费积分,实际成本可降至 $0。
Claude Code Router 是否支持 OpenRouter?
是的,OpenRouter 是支持的提供商之一。 OpenRouter 通过单一 API 让您能够访问 200 多个模型,因此将其添加到 Claude Code Router 可以有效地解锁 OpenRouter 上的所有模型(包括 Llama 变体等免费模型)。
Claude Code Router 是否适用于生产环境?
这是一个社区项目,并非 Anthropic 官方支持。 其质量对于个人/团队使用来说是稳固的,但尚未经过企业规模的实战测试。对于生产 AI 产品,请考虑使用 LiteLLM 或 Portkey 等专用网关,并结合 AI Perks 的免费积分。
通过路由器 + 免费积分将 Claude Code 成本降低 99%
Claude Code Router 本身可节省 50-99%。结合免费的 Anthropic、OpenAI 和 Google Cloud 积分,您的实际 Claude Code 成本将降至零。 AI Perks 提供:
- $1,000-$25,000+ 的免费 Anthropic 积分
- $500-$50,000+ 的免费 OpenAI 积分
- $1,000-$25,000+ 的 Google Cloud 积分
- 200+ 个额外的初创公司特权
智能路由。零付费。在 getaiperks.com 获取免费 AI 积分。
