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