ros/claude-code-router
1
0
Fork 0
mirror of https://github.com/musistudio/claude-code-router.git synced 2026-01-29 22:02:05 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
e7608ada4a0f3ad9e550bf3bab2eaf90f72477a6
claude-code-router/docs/i18n/zh-CN/docusaurus-plugin-content-docs/current/server/intro.md
musistudio e7608ada4a fix docs
2026-01-01 21:17:41 +08:00

2.4 KiB
Raw Blame History

Server 简介

Claude Code Router Server 是一个核心服务组件，负责将 Claude Code 的 API 请求路由到不同的 LLM 提供商。它提供了完整的 HTTP API，支持：

  • API 请求路由：将 Anthropic 格式的请求转换为各种提供商的 API 格式
  • 认证与授权：支持 API Key 认证
  • 配置管理：动态配置提供商、路由规则和转换器
  • Web UI：内置管理界面
  • 日志系统：完整的请求日志记录

架构概述

┌─────────────┐     ┌──────────────────┐     ┌──────────────┐
│ Claude Code │────▶│ CCR Server       │────▶│ LLM Provider │
│   Client    │     │  (Router +       │     │  (OpenAI/    │
└─────────────┘     │   Transformer)   │     │   Gemini/etc)│
                    └──────────────────┘     └──────────────┘
                           │
                           ├─ Web UI
                           ├─ Config API
                           └─ Logs API

核心功能

1. 请求路由

  • 基于 Token 数量的智能路由
  • 项目级路由配置
  • 自定义路由函数
  • 场景化路由（background、think、longContext 等）

2. 请求转换

  • 支持多种 LLM 提供商的 API 格式转换
  • 内置转换器：Anthropic、DeepSeek、Gemini、OpenRouter、Groq 等
  • 可扩展的转换器系统

3. Agent 系统

  • 插件式的 Agent 架构
  • 内置图片处理 Agent
  • 自定义 Agent 支持

4. 配置管理

  • JSON5 格式配置文件
  • 环境变量插值
  • 配置热更新（需重启服务）

使用场景

场景一：个人本地服务

在本地运行服务，供个人 Claude Code 使用：

ccr start

场景二：团队共享服务

使用 Docker 部署，为团队成员提供共享服务：

docker run -d -p 3456:3456 musistudio/claude-code-router

场景三：二次开发

基于暴露的 API 构建自定义应用：

GET /api/config
POST /v1/messages
GET /api/logs

下一步