dddAI 文档

切换主题

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 路由环境

项目链接：

先看这一条

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

CCR 和 dddAI 的关系 ​

对接 dddAI 时，最常见的做法是：

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

这意味着：

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

API 地址 ​

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

类型地址适用场景
API 地址https://dddai.dev/v1/chat/completions调用地址

配置建议

api_base_url 填写 https://dddai.dev/v1/chat/completions。

快速安装与启动 ​

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

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

再安装 Claude Code Router：

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

常见使用流程：

bash
# 启动本地路由服务
ccr start

# 通过 CCR 启动 Claude Code
ccr code

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

bash
eval "$(ccr activate)"
claude

activate 的作用

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

推荐配置思路 ​

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

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

对接 dddAI 时，最重要的是两个部分：

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

一个适合 dddAI 的最小示例：

json
{
  "Providers": [
    {
      "name": "dddai",
      "api_base_url": "https://dddai.dev/v1/chat/completions",
      "api_key": "$DDDAI_API_KEY",
      "models": [
        "claude-3-7-sonnet",
        "claude-3-5-sonnet",
        "gpt-4o-mini"
      ]
    }
  ],
  "Router": {
    "default": "dddai,claude-3-7-sonnet",
    "background": "dddai,gpt-4o-mini",
    "think": "dddai,claude-3-7-sonnet",
    "longContext": "dddai,claude-3-5-sonnet"
  }
}

说明：

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

关于 transformer ​

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

对接 dddAI 这种 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 服务本身还没启动

先执行：

bash
ccr start
eval "$(ccr activate)"

3. 为什么登录或支付要走官网 ​

因为站外关联登录和站内支付属于账号体系相关操作，请统一使用官网 https://dddai.dev。

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

可以先按这个顺序：

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

先跑通，再慢慢细分。

相关页面 ​

API Base URL: https://dddai.dev/v1

Copyright © dddAI