使用 Cursor 的 自带 Key(BYOK)+ OpenAI 兼容地址接入。适用于兼容的聊天模型;Tab 补全、Composer 等 Cursor 自有能力有独立限制,见下方 FAQ。

三步配置

1

打开模型设置,填写 Key 和地址

Cursor 下载页选择 Mac ARM64(Apple Silicon)或 Mac x64(Intel)。安装并打开应用、完成登录后,按 Cmd + Shift + J 打开 Cursor Settings。
官方下载页提供三种系统的安装包。在 Cursor Settings → Models 找到 API Keys,下方配置三端通用:保存配置。此字段要带 /v1:复制 https://www.abcrelay.com/v1,不要填写根域名或完整 /chat/completions 地址。Key 只填原文。
2

添加并选择准确模型 ID

Models 中添加自定义模型,填写 ABCRelay 控制台开放的准确模型 ID,并启用该模型。模型需要兼容此入口的 OpenAI 聊天协议。新建聊天,明确选择刚添加的模型,首次验证不使用 AutoComposer
3

发一条消息,核对本站记录

发送 只回复 OK,不调用工具。正常回复后,在 ABCRelay 控制台核对同一时间、同一令牌及模型的调用记录。设置页的保存或 Key 校验结果不能替代真实调用验证。实际请求会消耗额度;Agent 的工具调用需另外验证。

FAQ 与详细说明

不同客户端的字段与地址写法,见 Base URL 对照表
这里配置的是 OpenAI API Key → Override OpenAI Base URL,填写 https://www.abcrelay.com/v1。Cursor 官方工作人员明确说明,中转站地址应包含 /v1。具体请求路径还取决于 Cursor 版本、模型和模式。不能通过删掉 /v1 来切换到 Anthropic Messages,也不要把 /chat/completions/responses 直接加在 Base URL 末尾。模型的品牌不决定地址写法,所选入口和协议才决定。部分模型或版本存在请求体与路径不匹配的问题,正确的 URL 不能单独解决这些兼容性问题,仍需检查真实请求。
macOS 的 Cmd + Shift + J、Windows / Linux 的 Ctrl + Shift + J 打开的是 Cursor SettingsCmd/Ctrl + , 打开普通编辑器设置,两者不同。自定义键位可能覆盖默认快捷键,可通过命令面板或菜单打开 Cursor Settings。使用 WSL 开发时,在 Windows 安装 Cursor,再通过其 WSL 工作流连接 Linux 项目。Windows 应用的模型设置与 WSL 内运行的 CLI 是独立的;Linux 终端环境变量不会自动配置 Cursor BYOK。
这里使用 OpenAI 兼容协议,并通过 Override OpenAI Base URL 把请求送往 ABCRelay。Key 与地址必须同时匹配,只改 Key 会让请求仍发往原服务。官方 API Key 文档对 OpenAI 列出标准非推理聊天模型;自定义模型还取决于 Cursor 与渠道的实际兼容性。不能因为模型在本站存在,就保证它的 Responses、推理或 Agent 工具能力在 Cursor BYOK 中全部可用。需要 Anthropic Messages 的接入可选 Claude Code CLIClaude 桌面版。不要把 Cursor 的 Anthropic 官方 Key 字段误认为它也提供独立网关地址。
官方说明自带 API Key 用于聊天模型,Tab 补全仍使用 Cursor 自有模型。Cursor 订阅、专有模型和 ABCRelay 余额是不同的产品与计费来源。当前 Base URL 覆盖存在跨模型路由限制。切回 Cursor 订阅模型时,关闭 Override OpenAI Base URL 和相关自带 Key 开关,再新建聊天;使用 ABCRelay 时再开启并明确选择自定义模型。官方工作人员确认暂不提供按模型、按供应商独立配置多个地址的完整支持。
确认 Key 与地址都属于 ABCRelay,覆盖和 Key 开关均开启,地址为 https://www.abcrelay.com/v1。模型 ID 大小写与控制台保持一致,检查余额、令牌限制和渠道状态。校验可能使用固定模型,最终应以你选择的可用模型的真实请求与本站日志判断。更新配置后新建聊天。若服务端没有任何调用记录,优先检查客户端路由、覆盖开关与网络;不要据此判断本站已接收到请求。
官方说明请求会经过 Cursor 服务器进行最终提示词构建;Key 随请求通过加密连接发送到其后端,官方称不会持久保存。因此 Cursor 后端也必须能访问网关,不能使用仅本机可访问的地址。ABCRelay 示例使用公网 HTTPS 地址。若仍失败,检查网关针对外部请求的访问策略和错误记录。使用 BYOK 时,Cursor 的 Zero Data Retention 承诺不直接适用,数据处理受所选服务的政策约束,详见官方说明。
先更新 Cursor,再确认打开的是 Cursor Settings → Models。若版本或组织策略没有 Override OpenAI Base URL,仅填 Key 无法完成此网关接入;可使用 ClineContinue常见错误见故障排查