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。

  • 一個模型 ID,完全依照 GET /v1/models 列出的寫法,例如 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

    直接呼叫端點

    先用你的金鑰執行這段指令。若收到含 choices 陣列的 JSON 回覆,就代表位址、金鑰與模型都沒問題。

    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 自己的模型無法使用了。覆寫仍處於開啟狀態。使用這些模型時請把它關閉。