Cursor 配置教程

在 Cursor 中接入 Crazyrouter，并了解 BYOK 模式下的可用范围、限制与排障方法

更新日期：2026-06-06

Cursor 适合把 Crazyrouter 接到日常编码工作流里，用来做聊天、代码解释、重构建议和常规编辑辅助。

概览

通过 Cursor 的 BYOK（Bring Your Own Key）能力，你可以把部分聊天模型请求切到 Crazyrouter，并按自己的 token 计费。

推荐接法：OpenAI 兼容模式

Crazyrouter Base URL：https://api.crazyrouter.com/v1

认证方式：sk-... token

最适合先接入的功能：Chat、Ask、常规编辑对话

Warning: 根据 Cursor 官方文档，Custom API keys only work with standard chat models，像 Tab Completion 这类依赖专用模型的功能会继续使用 Cursor 内置模型。这个限制来自 Cursor 本身，而不是 Crazyrouter。

适合谁用

想在 Cursor 里统一使用 Crazyrouter token 的开发者

想控制模型选择、成本和额度的人

想把 Cursor 聊天能力接到 Crazyrouter 的团队

想给不同 IDE / CLI 分开计费和限额的人

使用协议

推荐协议：OpenAI-compatible API

Cursor 里对接 Crazyrouter 时，使用 OpenAI 兼容基址：

https://api.crazyrouter.com/v1

不要填成：

https://api.crazyrouter.com

https://api.crazyrouter.com/v1/chat/completions

前置条件

项目	说明
Crazyrouter 账号	先在 crazyrouter.com 注册
Crazyrouter token	建议单独创建一个给 Cursor 使用的 `sk-...` token
Cursor 桌面端	建议升级到当前稳定版后再配置
可用模型	至少保证 token 放行了 1 到 2 个 OpenAI 兼容聊天模型

推荐先放行这些模型之一：

gpt-5.5

claude-opus-4-8

gemini-3.1-pro

Tip: 如果你后续还要配置 Claude Code、Codex、Cline，不要和 Cursor 共用同一个 token。单独拆 token 更方便排查和控费。

5 分钟快速开始

创建 Cursor 专用 token

在 Crazyrouter 后台创建一个新 token，名称建议直接写 cursor。先开启少量模型白名单，例如 gpt-5.5 与 claude-opus-4-8。

打开 Cursor 设置

打开 Cursor，进入 Cursor Settings → Models。

填写 OpenAI 接入信息

在 OpenAI 相关配置区域填写：

OpenAI API Key: 你的 sk-...

Override OpenAI Base URL: https://api.crazyrouter.com/v1

如果你的 Cursor 版本没有看到 Override OpenAI Base URL，说明当前版本的自定义 OpenAI 兼容端点支持不完整，需要先升级 Cursor，或等待 Cursor 侧进一步完善该能力。

验证密钥并选择模型

点击 Verify。通过后，优先启用一个模型做首次验证，建议先选 gpt-5.5。

完成首次测试

打开 Cursor 的聊天面板，发送一句简单请求，例如：Reply with only OK。只要成功返回，就说明 Crazyrouter 接通了。

使用场景	推荐模型	原因
默认主力	`gpt-5.5`	2026 年 3 月 23 日已在生产环境实测成功，适合作为 Cursor OpenAI 兼容主基线
高质量代码与长文	`claude-opus-4-8`	更适合复杂解释、总结和代码辅助
Gemini 备用档	`gemini-3.1-pro`	适合作为第二条兼容性验证路径

Token 设置最佳实践

设置	建议	说明
专用 token	必须	Cursor 单独一个 token，避免和别的工具混用
模型白名单	建议开启	只放行 Cursor 实际要用的模型
IP 限制	视情况开启	个人电脑出口不固定时通常不建议；固定办公网可考虑开启
配额上限	强烈建议	给 Cursor 单独设预算，避免一次性吃掉总额度
开发 / 生产分离	建议	个人机器、团队机器、CI 机分别用不同 token
轮换频率	建议定期	如果截图、录屏或同步配置可能泄露 token，要及时重置

验证清单

Cursor Settings → Models 中的 key 能通过 Verify

Override OpenAI Base URL 已正确设置为 https://api.crazyrouter.com/v1

已成功选择至少一个 Crazyrouter 模型

聊天面板的第一条请求成功返回

Crazyrouter 后台日志能看到对应请求

token 配额与模型白名单符合预期

你知道 Tab Completion 等专用能力可能不会走 Crazyrouter

常见错误与修复

现象	常见原因	修复方式
`Verify` 失败	API Key 错误，或 Base URL 写错	重新检查 `sk-...` 和 `https://api.crazyrouter.com/v1`
401 unauthorized	token 无效、过期或复制时带了空格	重新生成 token 并粘贴纯净值
403 / model not allowed	当前模型不在 token 白名单内	在 Crazyrouter token 设置里放行对应模型
404	Base URL 填成了根域名或具体接口路径	统一改成 `https://api.crazyrouter.com/v1`
模型列表不对或没有模型	Cursor BYOK 刷新失败，或版本兼容性问题	重启 Cursor，重新 Verify，必要时升级到最新稳定版
聊天能用但 Tab 补全不走 Crazyrouter	Cursor 官方限制：专用能力仍会走内置模型	这是预期行为，不是 Crazyrouter 故障
自定义模型无法使用	Cursor 对自定义 OpenAI 兼容端点支持不稳定	先用 `gpt-5.5` 跑通，再逐步尝试其他模型
成本异常升高	多个功能共用同一 token，或白名单过宽	缩小模型范围，并为 Cursor 单独设置额度

性能与成本建议

第一阶段先只开 gpt-5.5

复杂代码解释、总结和重构优先走 gpt-5.5

如果你要做多供应商验证，再补 claude-opus-4-8 与 gemini-3.1-pro

如果你同时在用 Claude Code / Codex，务必拆分 token 统计成本

遇到可疑高消耗时，先回看 Crazyrouter 日志确认是不是 Cursor 的多轮上下文导致

FAQ

Cursor 里应该填哪个 Base URL？

填：https://api.crazyrouter.com/v1

为什么我填了 Key，但某些功能还是没走 Crazyrouter？

因为 Cursor 官方说明自定义 API key 只覆盖标准聊天模型，像 Tab Completion 这样的专用能力仍会使用 Cursor 自己的模型。

第一次推荐用哪个模型？

先用 gpt-5.5。它是当前已实测成功的最新 OpenAI 兼容基线。

能不能直接用 Claude 或其他模型？

可以尝试，但建议先完成 OpenAI 兼容路径的基础验证。某些自定义模型是否能在 Cursor 当前版本中顺利工作，取决于 Cursor 的兼容实现。

聊天正常但模型选择总是乱掉怎么办？

先重启 Cursor，再重新 Verify；如果问题仍存在，优先回退到 gpt-5.5 这种已实测成功的基线模型。

Note: 如果你主要想把 Crazyrouter 用在稳定的编码工作流里，Claude Code、Codex、Cline 往往比 Cursor 的自定义端点路径更直接可控。Cursor 更适合先接入聊天和常规编辑辅助。

原教程截图

最后校验/修改：2026-09-28（API Base URL 由 cn.crazyrouter.com 统一改为 https://api.crazyrouter.com，共 9 处；账号/控制台仍为 https://crazyrouter.com）

概览#

适合谁用#

使用协议#

前置条件#

5 分钟快速开始#

创建 Cursor 专用 token#

打开 Cursor 设置#

填写 OpenAI 接入信息#

验证密钥并选择模型#

完成首次测试#

推荐模型配置#

Token 设置最佳实践#

验证清单#

常见错误与修复#

性能与成本建议#

FAQ#

Cursor 里应该填哪个 Base URL？#

为什么我填了 Key，但某些功能还是没走 Crazyrouter？#

第一次推荐用哪个模型？#

能不能直接用 Claude 或其他模型？#

聊天正常但模型选择总是乱掉怎么办？#

原教程截图#

概览