Claude Code Router - 智能AI模型路由器

项目概述

Claude Code Router是一个革命性的AI模型路由工具，让你以极低成本享受Claude Code的强大功能

核心特性

强大的路由功能集合，重新定义AI编程的成本效益

🔀

智能路由系统

基于上下文长度、任务类型和模型特性的智能路由算法，自动选择最适合的AI模型处理不同类型的请求。

路由策略：默认模型、后台任务、思考模式、长上下文
智能分析：Token计数、任务类型识别、模型特性匹配
动态切换：/model命令、实时模型切换、配置热更新

💰

成本大幅优化

使用DeepSeek等低成本模型替代昂贵的Claude API，成本降低至原来的1/10，无需订阅Claude Max计划。

成本对比：DeepSeek价格不到Claude Sonnet 3.5的1/10
优惠时段：DeepSeek夜间时段额外50%-75%折扣
免费选项：支持Ollama本地模型、免费API提供商

🌐

多提供商支持

支持OpenRouter、DeepSeek、Ollama、Gemini、火山引擎等多个AI提供商，灵活配置，避免单一依赖。

支持提供商：OpenRouter、DeepSeek、Ollama、Gemini、火山引擎
模型选择：Claude、GPT、Gemini、Qwen、DeepSeek-R1等
请求转换：自动处理不同API格式差异和兼容性

技术架构

基于Express.js和@musistudio/llms构建的高性能路由系统

⚡

Express.js服务器

高性能HTTP服务器，处理/v1/messages端点

🔧

@musistudio/llms

统一的LLM接口库，处理多提供商兼容性

📦

esbuild构建

快速TypeScript编译和CLI打包

🎯

智能中间件

请求/响应转换和路由决策处理

⚙️

CLI工具

ccr命令行界面，支持服务管理

📊

Token计数

tiktoken实时上下文长度分析

路由策略详解

四种智能路由模式，针对不同场景优化性能和成本

🎯

default - 默认模式

处理日常编程任务的主力模型，兼顾性能和成本

推荐配置：deepseek,deepseek-chat
适用场景：代码生成、调试、重构、一般性问答
成本优势：相比Claude降低90%成本

⚙️

background - 后台任务

处理低智能要求的后台任务，如摘要生成、简单分析

推荐配置：ollama,qwen2.5-coder:latest
适用场景：代码摘要、对话总结、简单格式化
成本优势：本地运行，完全免费

🧠

think - 思考模式

启用推理能力的高级模型，用于复杂问题解决

推荐配置：deepseek,deepseek-reasoner
适用场景：复杂算法设计、架构规划、问题诊断
特殊功能：支持Think和UltraThink模式

📚

longContext - 长上下文

处理超过32K token的长上下文场景

推荐配置：openrouter,google/gemini-2.5-pro-preview
适用场景：大型项目分析、长文档处理
自动触发：上下文超过32K时自动切换

路由优势

智能分析：基于tiktoken实时计算上下文长度，精确路由
任务识别：自动识别后台任务、思考任务、长上下文场景
成本优化：根据任务复杂度选择合适成本的模型
性能平衡：在成本和性能之间找到最佳平衡点
动态切换：支持/model命令实时切换模型

安装配置指南

三步快速上手，开始你的低成本AI编程之旅

1. 安装Claude Code

安装官方Claude Code

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

2. 安装Claude Code Router

安装路由器

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

3. 启动服务

启动Claude Code Router

# 启动Claude Code（通过路由器）
ccr code

# 或者分别启动服务和客户端
ccr start    # 启动路由服务
ccr status   # 查看服务状态
ccr stop     # 停止服务

配置文件位置

在 ~/.claude-code-router/config.json 创建配置文件：

完整配置示例

{
  "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": "ollama",
      "api_base_url": "http://localhost:11434/v1/chat/completions",
      "api_key": "ollama",
      "models": ["qwen2.5-coder:latest"]
    },
    {
      "name": "openrouter",
      "api_base_url": "https://openrouter.ai/api/v1/chat/completions",
      "api_key": "sk-xxx",
      "models": [
        "google/gemini-2.5-pro-preview",
        "anthropic/claude-3.5-sonnet"
      ]
    }
  ],
  "Router": {
    "default": "deepseek,deepseek-chat",
    "background": "ollama,qwen2.5-coder:latest",
    "think": "deepseek,deepseek-reasoner",
    "longContext": "openrouter,google/gemini-2.5-pro-preview"
  }
}

基本使用

命令行操作

# 直接使用（自动启动服务）
ccr code "帮我写一个快速排序算法"

# 在Claude Code中切换模型
/model openrouter,anthropic/claude-3.5-sonnet

# 服务管理
ccr start    # 启动后台服务
ccr status   # 查看服务状态
ccr stop     # 停止服务

成本优化技巧

🕐 时间优化：在北京时间00:30-08:30使用DeepSeek API，享受50%-75%折扣

🏠 本地模型：使用Ollama运行本地模型处理后台任务，完全免费

🎯 智能路由：让系统自动选择最适合的模型，平衡成本和性能

GitHub Actions集成

在 .github/workflows/claude.yaml 中配置：

GitHub Actions配置

name: Claude Code

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]

jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Prepare Environment
        run: |
          curl -fsSL https://bun.sh/install | bash
          mkdir -p $HOME/.claude-code-router
          cat << 'EOF' > $HOME/.claude-code-router/config.json
          {
            "log": true,
            "OPENAI_API_KEY": "${{ secrets.OPENAI_API_KEY }}",
            "OPENAI_BASE_URL": "https://api.deepseek.com",
            "OPENAI_MODEL": "deepseek-chat"
          }
          EOF

      - name: Start Claude Code Router
        run: |
          nohup ~/.bun/bin/bunx @musistudio/[email protected] start &

      - name: Run Claude Code
        uses: anthropics/claude-code-action@beta
        env:
          ANTHROPIC_BASE_URL: http://localhost:3456
        with:
          anthropic_api_key: "test"