RealRelay.ai
编码智能体

Cursor 接入指南

通过覆盖 OpenAI 基础地址把 Cursor 接入 RealRelay.ai：确认套餐、设置密钥和基础地址、添加自定义模型，并测试 Chat 和 Agent。实验性。

创建 API 密钥浏览目录
协议
OpenAI Chat Completions
基础地址
https://www.realrelay.ai/v1
官方文档
cursor.com
已对照工具官方文档核对
2026-10
实验性. 尚未在 RealRelay.ai 上端到端跑通。步骤依据该工具的官方文档；如果某一步失败，请带上错误信息联系支持。

概览

Cursor 是一款以 AI 聊天和可编辑项目的智能体为核心的代码编辑器。使用你自己的密钥时，Cursor 会把 Chat 和 Agent 请求发往一个 OpenAI 兼容的地址，因此接入的是 RealRelay.ai 的 /v1/chat/completions 端点。

  • 一个从控制台的 API 密钥页面获取的 API 密钥。

  • 带 /v1 的基础地址。

  • 一个与 GET /v1/models 列出的完全一致的模型 ID，例如 z-ai/glm-5.2。每个模型都需要手动添加。

  • 一个允许使用自有 API 密钥的 Cursor 套餐：Premium、Super 或 Ultra，或旧版的 Pro、Pro+ 和 Ultra 套餐。Free 和 Plus 不支持。在 Teams 和 Enterprise 套餐中，用你的密钥发出的请求仍会被 Cursor 按其 token 费率计费。

本指南为实验性。Cursor 的文档中并没有介绍基础地址覆盖功能；这些步骤来自 Cursor 工作人员在 Cursor 论坛上的回答，不同版本之间可能有变化。部分 Cursor 版本发送的请求体与标准 Chat Completions 不同，而 RealRelay.ai 不会改写这些请求体，所以可能出现 Chat 正常而 Agent 模式失败的情况。Tab 补全始终使用 Cursor 自己的模型。

安装

从 cursor.com/downloads 下载 Cursor。在 macOS（12 或更高版本）上打开 .dmg；在 Windows（10 或更高版本）上运行 .exe。在 Linux 上，请使用 Cursor 的软件包仓库，或同一页面上的 AppImage。

Debian · Ubuntu
1curl -fsSL https://downloads.cursor.com/keys/anysphere.asc | gpg --dearmor | sudo tee /etc/apt/keyrings/cursor.gpg > /dev/null2echo "deb [arch=amd64,arm64 signed-by=/etc/apt/keyrings/cursor.gpg] https://downloads.cursor.com/aptrepo stable main" | sudo tee /etc/apt/sources.list.d/cursor.list > /dev/null3sudo apt update4sudo apt install cursor
RHEL · Fedora
1sudo tee /etc/yum.repos.d/cursor.repo << 'EOF'2[cursor]3name=Cursor4baseurl=https://downloads.cursor.com/yumrepo5enabled=16gpgcheck=17gpgkey=https://downloads.cursor.com/keys/anysphere.asc8EOF9sudo dnf install cursor

打开 Cursor 并登录你的 Cursor 账户。你自己的密钥是在账户之上额外使用的，并不能取代账户。

配置

  1. 1

    打开模型设置

    打开 Cursor Settings，进入 Models。

  2. 2

    填入密钥

    打开 OpenAI API Key 开关，粘贴你的 RealRelay.ai 密钥。

    Cursor Settings → Models → OpenAI API Key
    sk-***
  3. 3

    覆盖基础地址

    打开 Override OpenAI Base URL 开关。启用后，该字段会自动填入 OpenAI 的地址；请把它替换为 RealRelay.ai 的地址。

    Cursor Settings → Models → Override OpenAI Base URL
    https://www.realrelay.ai/v1
  4. 4

    添加模型

    在模型搜索框中输入确切的模型 ID，然后点击 Add Custom Model。每个要用的模型都重复一遍。不需要点 Refresh Model List。

    Cursor Settings → Models → Add Custom Model
    z-ai/glm-5.2
  5. 5

    选中模型

    在 Chat 或 Agent 的模型菜单中选择新添加的模型。

  • 每个请求在到达 RealRelay.ai 之前都会经过 Cursor 的服务器，你的密钥也随之传输。Cursor 表示不会存储该密钥。Cursor 的零数据保留（Zero Data Retention）政策不涵盖用你自己的密钥发出的请求。

  • 覆盖设置会作用于所有 OpenAI 系列的请求，包括 Cursor 自己的部分模型。要改回使用 Cursor 的模型，请关闭覆盖。

验证

  1. 1

    直接调用端点

    先用你的密钥运行这条命令。如果返回的 JSON 包含 choices 数组，说明地址、密钥和模型都没问题。

    Terminal
    1curl -sS "https://www.realrelay.ai/v1/chat/completions" \2  -H "Authorization: Bearer sk-***" \3  -H "Content-Type: application/json" \4  -d '{"model": "z-ai/glm-5.2", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with OK"}]}'
  2. 2

    发送一条 Chat 消息

    在 Chat 中选择你的自定义模型，问一个简短的问题。收到回复，并在控制台的用量日志中看到对应请求，即说明覆盖已生效。

  3. 3

    测试 Agent 模式

    用同一个模型切换到 Agent，让它做一个小的文件改动。如果文件被创建出来，说明工具调用端到端可用。如果智能体只描述了改动，请参阅“故障排查”。

    Cursor Agent
    Create a file named relay-check.txt that contains the word OK.

模型

Cursor 不读取 RealRelay.ai 的模型列表。每个要用的模型都通过 Add Custom Model 添加，ID 与 RealRelay.ai 列出的完全一致，然后在模型菜单中选择它。Cursor 不会要求你填写上下文窗口或输出上限。

Agent 模式请选择支持工具调用、上下文窗口至少 64K token 的模型；模型目录中列出了每个模型的这两项信息。参见选择模型。

故障排查

  • 报错称该模型不适用于你的套餐或密钥。你的套餐不允许使用自有密钥。Free 和 Plus 不够；请查看 Cursor 的套餐页面。

  • 点击 Add Custom Model 没有反应。该名称与 Cursor 已有的某个模型重名，请求会走 Cursor 而不是你的密钥。RealRelay.ai 的 ID 带有 z-ai/ 这样的前缀，请复制完整的 ID。

  • 401 或“invalid API key”。检查覆盖字段里填的是 RealRelay.ai 的地址，而不是默认的 OpenAI 地址，并确认粘贴的密钥中没有空格。

  • 400 并提到 tools、type 或 input。你的 Cursor 版本发送了非标准 Chat Completions 的请求体。RealRelay.ai 不会转换这类请求体。请用 Chat 代替 Agent，或换一个 Cursor 版本。

  • 智能体只描述修改，却不实际改文件。模型的工具调用没有完整地传回 Cursor。换一个支持工具调用的模型试试。

  • 在代理后面出现 read ECONNRESET。把 Cursor 的网络模式切换为 HTTP/1.1，然后完全退出并重启 Cursor。

    Cursor Settings → Network → HTTP Compatibility Mode
    HTTP/1.1

  • Cursor 自己的模型无法使用了。覆盖设置仍处于开启状态。使用这些模型时请关闭它。