概览
通过 Cursor 的 BYOK(Bring Your Own Key)能力,你可以把部分聊天模型请求切到 Crazyrouter,并按自己的 token 计费。- 推荐接法:OpenAI 兼容模式
- Crazyrouter Base URL:
https://crazyrouter.com/v1 - 认证方式:
sk-...token - 最适合先接入的功能:Chat、Ask、常规编辑对话
适合谁用
- 想在 Cursor 里统一使用 Crazyrouter token 的开发者
- 想控制模型选择、成本和额度的人
- 想把 Cursor 聊天能力接到 Crazyrouter 的团队
- 想给不同 IDE / CLI 分开计费和限额的人
使用协议
推荐协议:OpenAI-compatible API
Cursor 里对接 Crazyrouter 时,使用 OpenAI 兼容基址:
https://crazyrouter.comhttps://crazyrouter.com/v1/chat/completions
前置条件
| 项目 | 说明 |
|---|---|
| Crazyrouter 账号 | 先在 crazyrouter.com 注册 |
| Crazyrouter token | 建议单独创建一个给 Cursor 使用的 sk-... token |
| Cursor 桌面端 | 建议升级到当前稳定版后再配置 |
| 可用模型 | 至少保证 token 放行了 1 到 2 个 OpenAI 兼容聊天模型 |
gpt-5.4claude-sonnet-4-6gemini-3-pro-preview
5 分钟快速开始
创建 Cursor 专用 token
在 Crazyrouter 后台创建一个新 token,名称建议直接写
cursor。先开启少量模型白名单,例如 gpt-5.4 与 claude-sonnet-4-6。填写 OpenAI 接入信息
在 OpenAI 相关配置区域填写:
OpenAI API Key: 你的sk-...Override OpenAI Base URL:https://crazyrouter.com/v1
Override OpenAI Base URL,说明当前版本的自定义 OpenAI 兼容端点支持不完整,需要先升级 Cursor,或等待 Cursor 侧进一步完善该能力。推荐模型配置
| 使用场景 | 推荐模型 | 原因 |
|---|---|---|
| 默认主力 | gpt-5.4 | 2026 年 3 月 23 日已在生产环境实测成功,适合作为 Cursor OpenAI 兼容主基线 |
| 高质量代码与长文 | claude-sonnet-4-6 | 更适合复杂解释、总结和代码辅助 |
| Gemini 备用档 | gemini-3-pro-preview | 适合作为第二条兼容性验证路径 |
gpt-5.4 跑通,再逐步尝试 claude-sonnet-4-6 和 gemini-3-pro-preview。
Token 设置最佳实践
| 设置 | 建议 | 说明 |
|---|---|---|
| 专用 token | 必须 | Cursor 单独一个 token,避免和别的工具混用 |
| 模型白名单 | 建议开启 | 只放行 Cursor 实际要用的模型 |
| IP 限制 | 视情况开启 | 个人电脑出口不固定时通常不建议;固定办公网可考虑开启 |
| 配额上限 | 强烈建议 | 给 Cursor 单独设预算,避免一次性吃掉总额度 |
| 开发 / 生产分离 | 建议 | 个人机器、团队机器、CI 机分别用不同 token |
| 轮换频率 | 建议定期 | 如果截图、录屏或同步配置可能泄露 token,要及时重置 |
验证清单
-
Cursor Settings→Models中的 key 能通过Verify -
Override OpenAI Base URL已正确设置为https://crazyrouter.com/v1 - 已成功选择至少一个 Crazyrouter 模型
- 聊天面板的第一条请求成功返回
- Crazyrouter 后台日志能看到对应请求
- token 配额与模型白名单符合预期
- 你知道 Tab Completion 等专用能力可能不会走 Crazyrouter
常见错误与修复
| 现象 | 常见原因 | 修复方式 |
|---|---|---|
Verify 失败 | API Key 错误,或 Base URL 写错 | 重新检查 sk-... 和 https://crazyrouter.com/v1 |
| 401 unauthorized | token 无效、过期或复制时带了空格 | 重新生成 token 并粘贴纯净值 |
| 403 / model not allowed | 当前模型不在 token 白名单内 | 在 Crazyrouter token 设置里放行对应模型 |
| 404 | Base URL 填成了根域名或具体接口路径 | 统一改成 https://crazyrouter.com/v1 |
| 模型列表不对或没有模型 | Cursor BYOK 刷新失败,或版本兼容性问题 | 重启 Cursor,重新 Verify,必要时升级到最新稳定版 |
| 聊天能用但 Tab 补全不走 Crazyrouter | Cursor 官方限制:专用能力仍会走内置模型 | 这是预期行为,不是 Crazyrouter 故障 |
| 自定义模型无法使用 | Cursor 对自定义 OpenAI 兼容端点支持不稳定 | 先用 gpt-5.4 跑通,再逐步尝试其他模型 |
| 成本异常升高 | 多个功能共用同一 token,或白名单过宽 | 缩小模型范围,并为 Cursor 单独设置额度 |
性能与成本建议
- 第一阶段先只开
gpt-5.4 - 复杂代码解释、总结和重构优先走
gpt-5.4 - 如果你要做多供应商验证,再补
claude-sonnet-4-6与gemini-3-pro-preview - 如果你同时在用 Claude Code / Codex,务必拆分 token 统计成本
- 遇到可疑高消耗时,先回看 Crazyrouter 日志确认是不是 Cursor 的多轮上下文导致
FAQ
Cursor 里应该填哪个 Base URL?
填:https://crazyrouter.com/v1
为什么我填了 Key,但某些功能还是没走 Crazyrouter?
因为 Cursor 官方说明自定义 API key 只覆盖标准聊天模型,像 Tab Completion 这样的专用能力仍会使用 Cursor 自己的模型。第一次推荐用哪个模型?
先用gpt-5.4。它是当前已实测成功的最新 OpenAI 兼容基线。
能不能直接用 Claude 或其他模型?
可以尝试,但建议先完成 OpenAI 兼容路径的基础验证。某些自定义模型是否能在 Cursor 当前版本中顺利工作,取决于 Cursor 的兼容实现。聊天正常但模型选择总是乱掉怎么办?
先重启 Cursor,再重新 Verify;如果问题仍存在,优先回退到gpt-5.4 这种已实测成功的基线模型。
如果你主要想把 Crazyrouter 用在稳定的编码工作流里,Claude Code、Codex、Cline 往往比 Cursor 的自定义端点路径更直接可控。Cursor 更适合先接入聊天和常规编辑辅助。