文档
Claude Code Router
CCR 位于 Claude Code 与模型服务提供方之间,因此可以将不同类型的请求路由到不同位置。将 Kunavo 添加为自定义端点,然后通过 Agent Config 将每个 Claude 层级映射到一个模型 ID。
CCR 现在是桌面应用,不再使用 config.json:将 Kunavo 添加为自定义 API 端点,然后让其路由规则将每类请求发送到不同模型。
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-5config.json 已经不起作用。 CCR 将运行时配置保存在 ~/.claude-code-router/config.sqlite 中;仅当不存在 SQLite 配置时,才会将旧版 config.json 作为迁移来源读取一次。完成首次运行后,修改 JSON 文件会被静默忽略。网上的大多数说明——包括我们较早版本的指南——仍在介绍 JSON 文件。https://api.kunavo.com:CCR 会针对该地址探测协议,而 Kunavo 会在 /v1/messages 原生响应 Anthropic Messages。如果希望 CCR 使用 OpenAI 兼容格式,则改用 https://api.kunavo.com/v1——同一个密钥可用于这两种接口。sk-kn- 开头),并充值 $10 起——调用费用从该余额中扣除,失败的调用不会收费。随后,控制台会打开 Claude Code Router 设置页面。分步操作
- 在
/app/keys创建密钥并复制——它只会显示一次。 - 在 CCR Desktop 中打开 Providers → Add provider,选择预设
Other / custom API endpoint,然后填写 Name、API endpoint 和 API key。 - 在 Models 下添加模型 ID——使用 Search models 获取目录中的模型,或通过 Custom models 手动输入 ID。
- 对两到三个模型运行 Check Connection。这会发送真实请求,因此只选择需要验证的模型,无需选中整个列表。
- 打开 Agent Config → Add profile → Claude Code,设置 Model 以及各层级的 Opus / Sonnet / Haiku 覆盖项,保存后从 CCR 启动 Claude Code。
已于 2026年9月6日对照 CCR 的提供方配置页面检查。第三方设置会发生变化;如果这里的字段名称不再与你看到的内容一致,应以该页面为准,而不是本页。
调试客户端前先验证
一个请求即可确定故障来自端点、密钥还是配置文件。如果返回 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 的美元,格式为输入 / 输出。
| 模型 ID | Kunavo 输入 / 输出 | 它在 Claude Code Router 中的位置 |
|---|---|---|
claude-opus-5 | $3.50 / $17.50 | Opus 层级——用于规划和复杂编辑 |
claude-sonnet-5 | $1.40 / $7.00 | Sonnet 层级及配置文件默认值 |
claude-haiku-4-5 | $0.70 / $3.50 | Haiku 层级,子代理的大量调用会使用它 |
gpt-5-6-terra | $0.70 / $4.20 | 长上下文路由,可通过同一个提供方条目访问 |
为何按层级映射才是关键
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 与其通信时使用哪种线格式。