CCR - Claude Code Router 接入说明

这里的 CCR 指的是具体项目 Claude Code Router，不是泛指“Claude 路由类工具”。

Claude Code Router 由 musistudio 维护，它的核心定位是：

• 以 Claude Code 为基础构建可控的编码基础设施
• 将 Claude Code 请求路由到不同模型与提供商
• 支持请求 / 响应转换（transformer）
• 支持在 Claude Code 中通过 /model 动态切换模型
• 支持 ccr model、ccr ui、ccr preset 等管理方式
• 支持 ccr activate 把当前 shell 切换到 CCR 路由环境

项目链接：

• 中文文档：https://musistudio.github.io/claude-code-router/zh-CN/
• 英文文档：https://musistudio.github.io/claude-code-router/
• GitHub：https://github.com/musistudio/claude-code-router

先看这一条

CCR 本身是为 Claude Code 做“路由层”和“兼容层”的项目。接入嘀哩哩 AI 时，你实际配置的是 CCR 的 `Providers` 和 `Router`，而不是把所有模型都按 Anthropic 原生 `/messages` 去直连。

CCR 和嘀哩哩 AI 的关系

对接嘀哩哩 AI 时，最常见的做法是：

1. 在 CCR 的 Providers 中添加一个指向嘀哩哩 AI 的 provider
2. 在 models 中填写你账号下可用的模型名
3. 在 Router 中指定默认模型、思考模型、长上下文模型等路由规则
4. 启动 CCR 后，通过 ccr code 或 eval "$(ccr activate)" 使用 Claude Code

这意味着：

• Claude Code 实际先连到本地 CCR
• CCR 再把请求转发到你配置的嘀哩哩 AI 接口
• 如果需要，CCR 还可以对不同 provider 使用不同 transformer

备用地址

CCR 的 api_base_url 要填的是 完整聊天补全端点，而不只是 /v1 根地址。

类型	地址	适用场景
官方默认 API	https://api.dli.li/v1/chat/completions	官方默认调用地址
官方备用 API	https://api.dlizz.com/v1/chat/completions	官方备用调用地址

国内用户建议

`api_base_url` 可先填写官方默认 API `https://api.dli.li/v1/chat/completions`；如需使用官方备用 API，则填写 `https://api.dlizz.com/v1/chat/completions`。

快速安装与启动

先确保你已经安装了 Claude Code：

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

再安装 Claude Code Router：

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

常见使用流程：

# 启动本地路由服务
ccr start

# 通过 CCR 启动 Claude Code
ccr code

如果你希望直接继续用 claude 命令，也可以：

eval "$(ccr activate)"
claude

activate 的作用

`ccr activate` 会把当前 shell 的 `ANTHROPIC_BASE_URL`、`ANTHROPIC_AUTH_TOKEN` 等环境变量切到 CCR 的本地路由服务。前提是你已经先执行了 `ccr start`。

推荐配置思路

CCR 的核心配置文件通常是：

~/.claude-code-router/config.json

对接嘀哩哩 AI 时，最重要的是两个部分：

• Providers：定义上游提供商
• Router：定义不同场景使用哪个模型

一个适合嘀哩哩 AI 的最小示例：

{
  "Providers": [
    {
      "name": "dlili",
      "api_base_url": "https://api.dli.li/v1/chat/completions",
      "api_key": "$DLILI_API_KEY",
      "models": [
        "claude-3-7-sonnet",
        "claude-3-5-sonnet",
        "gpt-4o-mini"
      ]
    }
  ],
  "Router": {
    "default": "dlili,claude-3-7-sonnet",
    "background": "dlili,gpt-4o-mini",
    "think": "dlili,claude-3-7-sonnet",
    "longContext": "dlili,claude-3-5-sonnet"
  }
}

说明：

• name 是你自己定义的 provider 名称
• api_base_url 要写完整的 /v1/chat/completions
• api_key 建议通过环境变量注入，不要明文写死
• models 中的模型名必须和嘀哩哩 AI 实际暴露的一致
• Router.default 这类字段的格式通常是 provider_name,model_name

关于 transformer

Claude Code Router 支持 transformer，用来适配不同上游接口的请求和响应格式。

对接嘀哩哩 AI 这种 OpenAI 兼容接口时，通常可以先 不配 transformer，先按标准 OpenAI 兼容方式跑通。

只有在下面这些情况时，再考虑 transformer：

• 你要接的是非 OpenAI 兼容上游
• 某个模型有特殊参数兼容需求
• 你想利用 CCR 的 tooluse、reasoning、maxtoken 等能力做额外调整

模型选择建议

1. 先到 个人设置 查看当前账号可用模型。
2. 再到 API 令牌 确认当前 key 没有限制掉该模型。
3. 把模型名原样填进 CCR 的 models 列表。
4. 再在 Router 中按 provider,model 的格式引用。

常见问题

1. 为什么配置好了还是调用失败

优先检查：

• api_base_url 是否写成了完整的 /v1/chat/completions
• API Key 是否来自当前账号
• models 里的模型名是否和站点实际暴露名称完全一致
• 修改配置后是否执行了 ccr restart 或重新 ccr start

2. 为什么 claude 命令没有走 CCR

通常是因为：

• 你没有执行 eval "$(ccr activate)"
• 或者 CCR 服务本身还没启动

先执行：

ccr start
eval "$(ccr activate)"

3. 为什么登录或支付不能用备用域名

因为站外关联登录和站内支付必须使用主链接 https://dli.li。备用域名和加速域名主要用于 API 调用，不建议用于账号体系相关操作。

4. 我应该优先怎么配模型路由

可以先按这个顺序：

1. default：你最常用的主力模型
2. background：便宜一点、速度快一点的模型
3. think：更适合复杂推理的模型
4. longContext：适合长上下文的模型

先跑通，再慢慢细分。

相关页面

• Claude Code
• CC Switch
• API 接入
• 站点链接与计费规则