文档

文档

Claude Code Router

CCR 位于 Claude Code 与模型服务提供方之间,因此可以将不同类型的请求路由到不同位置。将 Kunavo 添加为自定义端点,然后通过 Agent Config 将每个 Claude 层级映射到一个模型 ID。

CCR 现在是桌面应用,不再使用 config.json:将 Kunavo 添加为自定义 API 端点,然后让其路由规则将每类请求发送到不同模型。

CCR Desktop
Providers → Add provider
  Preset provider   Other / custom API endpoint
  Name              Kunavo
  API endpoint      https://api.kunavo.com
  API key           sk-kn-...
  Models            claude-sonnet-5, claude-opus-5, claude-haiku-4-5

Agent Config → Add profile → Claude Code
  Model         Kunavo/claude-sonnet-5
  Opus model    Kunavo/claude-opus-5
  Haiku model   Kunavo/claude-haiku-4-5
手动编辑 config.json 已经不起作用。 CCR 将运行时配置保存在 ~/.claude-code-router/config.sqlite 中;仅当不存在 SQLite 配置时,才会将旧版 config.json 作为迁移来源读取一次。完成首次运行后,修改 JSON 文件会被静默忽略。网上的大多数说明——包括我们较早版本的指南——仍在介绍 JSON 文件。
此处的 API 端点是纯源站地址 https://api.kunavo.com:CCR 会针对该地址探测协议,而 Kunavo 会在 /v1/messages 原生响应 Anthropic Messages。如果希望 CCR 使用 OpenAI 兼容格式,则改用 https://api.kunavo.com/v1——同一个密钥可用于这两种接口。
还没有密钥?创建 Kunavo 账户,创建一个密钥(以 sk-kn- 开头),并充值 $10 起——调用费用从该余额中扣除,失败的调用不会收费。随后,控制台会打开 Claude Code Router 设置页面。

分步操作

  1. 在 /app/keys 创建密钥并复制——它只会显示一次。
  2. 在 CCR Desktop 中打开 Providers → Add provider,选择预设 Other / custom API endpoint,然后填写 Name、API endpoint 和 API key。
  3. 在 Models 下添加模型 ID——使用 Search models 获取目录中的模型,或通过 Custom models 手动输入 ID。
  4. 对两到三个模型运行 Check Connection。这会发送真实请求,因此只选择需要验证的模型,无需选中整个列表。
  5. 打开 Agent Config → Add profile → Claude Code,设置 Model 以及各层级的 Opus / Sonnet / Haiku 覆盖项,保存后从 CCR 启动 Claude Code。

已于 2026年9月6日对照 CCR 的提供方配置页面检查。第三方设置会发生变化;如果这里的字段名称不再与你看到的内容一致,应以该页面为准,而不是本页。

这是简要版本。完整教程——包括模型选择、真实会话成本和失败模式——见 Claude Code Router 指南。

调试客户端前先验证

一个请求即可确定故障来自端点、密钥还是配置文件。如果返回 JSON,则相同的基础 URL 和密钥可以在 Claude Code Router 中使用。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/messages \
  -H "Authorization: Bearer sk-kn-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'

字段中应填写哪个模型 ID

每个文本模型都可通过模型 ID 访问——实时列表见 GET /v1/models,包含价格的目录见模型页面。费率单位为每 1M token 的美元,格式为输入 / 输出。

模型 IDKunavo 输入 / 输出它在 Claude Code Router 中的位置
claude-opus-5$3.50 / $17.50Opus 层级——用于规划和复杂编辑
claude-sonnet-5$1.40 / $7.00Sonnet 层级及配置文件默认值
claude-haiku-4-5$0.70 / $3.50Haiku 层级,子代理的大量调用会使用它
gpt-5-6-terra$0.70 / $4.20长上下文路由,可通过同一个提供方条目访问
计费方式是从预付余额中按 token 扣费,无月费——参见 计费。对于重复上下文——这正是编辑器或聊天客户端发送内容的大部分——提示缓存对账单的影响大于模型选择。

为何按层级映射才是关键

Claude Code 会按层级选择模型,而非按请求选择:主循环请求 Sonnet 或 Opus 层级,后台工作——子代理、搜索、摘要——则请求轻量快速模型。CCR 的 Agent Config 将这些层级分别列为独立字段,因此只有确实需要的请求才会使用昂贵模型,而高频层级则会路由到廉价 ID。这种拆分正是要在 Claude Code 前运行路由器的全部理由,而且在 Claude Code 自身的设置中看不到这一配置。

常见问题

Claude Code Router 将配置存储在哪里?

配置存储在 SQLite 数据库中:macOS 和 Linux 上为 ~/.claude-code-router/config.sqlite,Windows 上为 %APPDATA%\claude-code-router\config.sqlite。只有在尚不存在 SQLite 配置时,才会将旧版 config.json 作为迁移来源读取一次;迁移完成后,编辑 config.json 不会影响运行配置。请改用桌面 UI 更改设置。

如何在 Claude Code Router 中添加自定义 API 端点?

打开 Providers,点击 Add provider,然后选择预设“Other / custom API endpoint”——该预设支持任何兼容 OpenAI、Anthropic 或 Gemini 的上游服务。填写唯一的 Name、API endpoint 基础 URL 和 API key,然后通过获取模型或在 Custom models 下手动输入模型 ID 来添加模型。Check Connection 会发送真实测试请求,以确认端点、密钥、协议和 ID 能够协同正常工作。

Claude Code Router 能否将不同 Claude 层级发送到不同模型?

可以,这正是运行它的主要理由。在 Agent Config 中,Claude Code 配置文件有一个默认 Model,以及可选的 Fable、Opus、Sonnet 和 Haiku 覆盖项。Claude Code 请求的是层级,而非特定 ID,因此将 Haiku 层级映射到廉价模型、将 Opus 层级映射到高性能模型,就能按照代理本身已有的工作方式拆分费用——高频后台工作使用廉价 ID,规划则使用昂贵模型。

Claude Code Router 能否与 Anthropic 格式的网关配合使用?

可以。自定义端点预设会针对你提供的 URL 探测协议,并支持 Anthropic Messages,因此可以直接添加提供 /v1/messages 的网关,并将其源站地址作为 API endpoint。如果网关还提供 OpenAI 兼容接口,两种方式都可以添加;区别仅在于 CCR 与其通信时使用哪种线格式。