用样例复核操作结果
- 遇到 Unable to reach the model provider,先记录 Cursor 中的模型 ID,再与渠道允许列表逐字比较。
- 下载并解压材料,运行
python3 replay.py,把保存的响应与预期逐字段比较。 - 在终端设置
QUICKROUTER_API_KEY,运行 python3 replay.py --run,直接向 QuickRouter 发一条计费文本请求。
用样例请求与允许列表定位模型拼写不一致。返回 requested、allowed、match。
2026-11-12 · deepseek-v4.1-flash · HTTP 200 · 181 tokens · 4729 ms · 字段断言未通过
样例输入
{
"requestModel": "claude-sonnet-5.5",
"allowedModels": ["claude-sonnet-5-5"]
}实际输出
{
"requested": "",
"allowed": "",
"match": true
}查看首轮未通过的响应
{
"requested": "",
"allowed": "",
"match": null
}复跑请求明确了字段类型或取值规则。下载包保留两次请求与响应。
预期结果:{
"requested": "claude-sonnet-5.5",
"allowed": "claude-sonnet-5-5",
"match": false
}
本页保存的文本调用结果。示例中的其他工具步骤可按官方文档在自己的环境执行。Cursor 的 Claude Key 与 OpenAI 自定义端点分开配置
Cursor 当前支持在 Anthropic API Key 区域配置自己 Anthropic 账号签发的 Key。OpenAI Base URL 覆盖不能保证把内置 Claude 或 claude- 前缀模型路由到 QuickRouter;需要网关 Claude 时,使用明确支持相应端点的客户端。
| 症状或目标 | 正确处理 | 验收条件 |
|---|
| 在 Cursor 使用原生 Claude BYOK | Settings → Models → Anthropic API Key,保存该厂商 Key | 新聊天选可用 Claude 模型取得回答 |
|---|
| 填 OpenAI Key 后 Claude 报 model not valid | 核对模型前缀对应的 Key 槽;不要假定 OpenAI 覆盖影响 Anthropic 路由 | 请求携带正确凭据并到达预期服务商 |
|---|
| 需要 QuickRouter 的 Claude 模型 | Claude Code 使用 Messages 网关;Cline 按专属教程选择 OpenAI Compatible | 核对各自协议、模型与工具调用支持,实际任务通过 |
|---|
| 需要 Cursor 的自定义 OpenAI 兼容模型 | 在该版本提供的 OpenAI Key 与 Base URL 覆盖入口配置 /v1 和准确 ID | 模型 ID 属于该入口支持范围,Cursor 实际聊天通过 |
|---|
| 看不到 API Keys 设置 | 核对版本与团队管理员的 Personal API Keys 权限 | 授权的 Provider 入口可见且已启用 |
|---|
| API 成功,Cursor 仍失败或达到用量上限 | 检查 Cursor 后端状态、所用功能及团队用量限制 | 原 Cursor 功能得到完整回答 |
|---|
- 症状或目标
- 在 Cursor 使用原生 Claude BYOK
- 正确处理
- Settings → Models → Anthropic API Key,保存该厂商 Key
- 验收条件
- 新聊天选可用 Claude 模型取得回答
- 症状或目标
- 填 OpenAI Key 后 Claude 报 model not valid
- 正确处理
- 核对模型前缀对应的 Key 槽;不要假定 OpenAI 覆盖影响 Anthropic 路由
- 验收条件
- 请求携带正确凭据并到达预期服务商
- 症状或目标
- 需要 QuickRouter 的 Claude 模型
- 正确处理
- Claude Code 使用 Messages 网关;Cline 按专属教程选择 OpenAI Compatible
- 验收条件
- 核对各自协议、模型与工具调用支持,实际任务通过
- 症状或目标
- 需要 Cursor 的自定义 OpenAI 兼容模型
- 正确处理
- 在该版本提供的 OpenAI Key 与 Base URL 覆盖入口配置 /v1 和准确 ID
- 验收条件
- 模型 ID 属于该入口支持范围,Cursor 实际聊天通过
- 症状或目标
- 看不到 API Keys 设置
- 正确处理
- 核对版本与团队管理员的 Personal API Keys 权限
- 验收条件
- 授权的 Provider 入口可见且已启用
- 症状或目标
- API 成功,Cursor 仍失败或达到用量上限
- 正确处理
- 检查 Cursor 后端状态、所用功能及团队用量限制
- 验收条件
- 原 Cursor 功能得到完整回答
从当前支持的原生 Claude 配置开始
- 在 Cursor Settings → Models 找到 Anthropic,保存自己的 Anthropic API Key。Key 与服务权限由该厂商账号提供;Cursor 订阅、Anthropic API 与 QuickRouter 余额分别管理。
- 新开聊天,从模型选择器选择该账号可用的 Claude 模型,发送“只回复 OK”。保存错误详情或 Request ID;BYOK 请求经 Cursor 后端,本机 API 成功还需客户端复测。
- 若目的是接入 QuickRouter Claude,先使用下方 Claude Code 或 Cline 专属步骤。只有当前 Cursor 版本明确支持目标网关和模型路由时,才继续相应自定义配置;不要通过改名掩盖协议或权限问题。
- 自带 Key 当前用于支持的聊天模型,Tab 继续使用 Cursor 内置模型。需要 Agent 等功能时,核对对应版本与模式并单独验收。
这是 Cursor 原生 Anthropic BYOK 的设置示意;QuickRouter 网关配置按下方客户端教程处理。
Cursor Settings → Models
Provider: Anthropic
API Key: 自己 Anthropic 账号签发的 Key
Action: Save
Model: 模型选择器中当前可用的 Claude
New Chat: 只回复 OK
下载 MIT 接入包与任务记录表核验日期与验证范围见各页记录;历史实测保留原日期,示例和空白记录表不等于真实任务结果。
把想用的模型,接入你的工具与应用
注册后创建 QuickRouter API Key,选择客户端和模型,再生成接入配置。从一次简单请求开始,按实际用量付费。
创建 API Key
在控制台创建令牌,选择需要使用的模型权限。
填写接入配置
按工具要求填写 API Key、接口地址与模型 ID。
发起第一次调用
确认收到有效结果,再到控制台查看用量与费用。