> ## Documentation Index
> Fetch the complete documentation index at: https://cc.cyber101.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code Router 

> 强大的 Claude Code 路由工具，支持多模型智能路由和成本优化

Claude Code Router 是一个强大的路由工具，允许您以 Claude Code 为基础构建编码基础设施，同时让您决定如何与模型交互，同时享受 Anthropic 的更新。
**GitHub**: [musistudio/claude-code-router](https://github.com/musistudio/claude-code-router)\
**Stars**: 10.3k+\
**License**: MIT

## [🚀 核心特性](#-核心特性)

### [多模型智能路由](#多模型智能路由)

* **智能路由**: 根据任务类型自动选择合适的模型
* **成本优化**: 使用更小的本地模型处理后台任务
* **长上下文处理**: 专门处理长上下文任务（>60K tokens）
* **推理增强**: 为推理密集型任务选择专用模型

### [多提供商支持](#多提供商支持)

* **OpenAI**: 完整的 OpenAI API 支持
* **Anthropic**: 原生 Claude API 支持
* **DeepSeek**: 适配 DeepSeek API
* **Gemini**: 支持 Google Gemini API
* **OpenRouter**: 多提供商路由支持
* **Groq**: 高性能推理支持

### [转换器系统](#转换器系统)

* **maxtoken**: 设置特定的 max\_tokens 值
* **tooluse**: 通过 tool\_choice 优化工具使用
* **reasoning**: 处理 reasoning\_content 字段
* **sampling**: 处理温度、top\_p、top\_k 等采样参数
* **enhancetool**: 为工具调用参数添加错误容忍层

## [📦 安装和配置](#-安装和配置)

### [快速开始](#快速开始)

```
# 安装
bunx @musistudio/claude-code-router@latest
# 创建配置目录
mkdir -p $HOME/.claude-code-router
# 复制示例配置
cp config.example.json $HOME/.claude-code-router/config.json
```

### [基础配置](#基础配置)

```
{
  "log": true,
  "OPENAI_API_KEY": "your-api-key",
  "OPENAI_BASE_URL": "https://api.deepseek.com",
  "OPENAI_MODEL": "deepseek-chat",
  "router": {
    "default": "openrouter,anthropic/claude-3.5-sonnet",
    "background": "openrouter,anthropic/claude-3-haiku",
    "think": "openrouter,anthropic/claude-3.5-sonnet",
    "longContext": "openrouter,anthropic/claude-3.5-sonnet",
    "longContextThreshold": 60000
  }
}
```

## [🔧 路由配置](#-路由配置)

### [默认路由场景](#默认路由场景)

```
{
  "router": {
    "default": "openrouter,anthropic/claude-3.5-sonnet",
    "background": "openrouter,anthropic/claude-3-haiku",
    "think": "openrouter,anthropic/claude-3.5-sonnet",
    "longContext": "openrouter,anthropic/claude-3.5-sonnet",
    "webSearch": "openrouter,anthropic/claude-3.5-sonnet:online"
  }
}
```

### [动态模型切换](#动态模型切换)

在 Claude Code 中使用 `/model` 命令动态切换模型：

```
/model openrouter,anthropic/claude-3.5-sonnet
```

## [⚡ 高级功能](#-高级功能)

### [自定义路由器](#自定义路由器)

创建自定义路由逻辑：

```
// $HOME/.claude-code-router/custom-router.js
module.exports = async function router(req, config) {
  const userMessage = req.body.messages.find((m) => m.role === "user")?.content;
  if (userMessage && userMessage.includes("explain this code")) {
    return "openrouter,anthropic/claude-3.5-sonnet";
  }
  return null; // 回退到默认路由器
};
```

### [子代理路由](#子代理路由)

在子代理提示开头指定特定模型：

```
<CCR-SUBAGENT-MODEL>openrouter,anthropic/claude-3.5-sonnet</CCR-SUBAGENT-MODEL>
请帮我分析这段代码的潜在优化...
```

### [GitHub Actions 集成](#github-actions-集成)

在 CI/CD 管道中集成 Claude Code Router：

```
name: Claude Code
on:
  issue_comment:
    types: [created]
jobs:
  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/claude-code-router@1.0.8 start &
      - name: Run Claude Code
        uses: anthropics/claude-code-action@beta
        env:
          ANTHROPIC_BASE_URL: http://localhost:3456
        with:
          anthropic_api_key: "any-string-is-ok"
```

## [🎯 使用场景](#-使用场景)

### [1. 成本优化](#1-成本优化)

* 使用较小的模型处理简单任务
* 在非高峰时段运行任务
* 智能路由减少 API 调用成本

### [2. 性能优化](#2-性能优化)

* 长上下文任务使用专用模型
* 推理任务使用高性能模型
* 后台任务使用轻量级模型

### [3. 多提供商支持](#3-多提供商支持)

* 避免单一提供商限制
* 利用不同提供商的优势
* 提高服务可用性

## [💡 最佳实践](#-最佳实践)

### [配置建议](#配置建议)

1. **合理设置阈值**: 根据项目需求调整 longContextThreshold
2. **监控使用情况**: 启用日志记录监控模型使用
3. **定期更新**: 保持工具和配置的最新状态
4. **测试配置**: 在生产环境前充分测试配置

### [安全考虑](#安全考虑)

1. **API 密钥管理**: 使用环境变量存储敏感信息
2. **访问控制**: 限制路由器的访问权限
3. **日志安全**: 避免在日志中记录敏感信息

## [📝 总结](#-总结)

Claude Code Router 为 Claude Code 提供了强大的路由能力，让您能够：

* **灵活选择模型**: 根据任务需求选择合适的 AI 模型
* **优化成本**: 通过智能路由降低 API 调用成本
* **提升性能**: 为不同任务类型选择最优模型
* **增强可用性**: 支持多种 AI 提供商，避免单点故障
  这个工具特别适合需要处理大量 AI 交互的团队和个人开发者，能够显著提升开发效率和成本效益。

***

*Claude Code Router 是 Claude Code 生态系统中不可或缺的工具，为开发者提供了灵活、高效、经济的 AI 模型路由解决方案。*

* [CCPM：Claude Code 项目管理器](/docs/tools/ccpm-project-manager) - 一个革命性的 Claude Code 项目管理系统，使用 GitHub Issues 和 Git worktrees 实现并行代理执行。将 PRD 转化为已发布的代码，具备完整的可追溯性和前所未有的开发速度。
* [Claude Code Templates: 配置和监控 Claude Code 的 CLI 工具](/docs/tools/claude-code-templates) - 一个全面的 CLI 工具，用于配置和监控 Claude Code，具有框架特定命令、实时分析仪表板和独立组件安装功能。