在 Cursor 裡使用

開啟 Override OpenAI Base URL、新增自訂模型,並了解哪些 Cursor 功能仍走官方後端。

Cursor 支援自備金鑰(BYOK):設定一組 OpenAI 相容的 base URL 加上你的 OLETOKEN 金鑰,Chat 的請求就會改由你的 OLETOKEN 餘額支付。

開始之前

  1. 你已建立 API 金鑰並保存完整金鑰。
  2. 你已從模型市場取得模型 ID。
  3. 你的 Cursor 版本支援自訂模型(Settings → Models 會顯示「Add Model」按鈕)。

設定

  1. 開啟設定:⌘⇧J(macOS)/ Ctrl⇧J(Windows、Linux),或 ⌘⇧PCursor Settings

  2. 前往 ModelsModel Names+ Add Model,輸入你要用的模型 ID 後按 Enter。

  3. 在同一頁的 API KeysOpenAI API Key 下方點 +,貼上你的 OLETOKEN 金鑰。

  4. 開啟 Override OpenAI Base URL,填入 OpenAI 相容位址,要包含 /v1

    https://<your-base-url>/v1
    

    Cursor 會在其後接上 /chat/completions,因此 /v1 不能省略。

  5. Verify。對於非 OpenAI 自家的模型名稱,驗證可能失敗——那是誤報;請直接在 Chat 中送訊息實測。

  6. 回到編輯器按 ⌘L / Ctrl+L 開啟 Chat,在模型下拉選單中選擇你的模型。

需要知道的事

  • 只有 Chat 與 Plan 涵蓋在內。 Composer、Tab 補全與 Inline Edit 仍走 Cursor 自己的後端,不會花用你的 OLETOKEN 餘額。
  • 內建的 Anthropic 模型可能受影響。 開啟 Override OpenAI Base URL 後,Cursor 內建的 Claude 模型也可能被導到本站。若你仍想用官方版本,請以 + Add Model 把 Claude 模型 ID 加為自訂模型,並在下拉選單中選擇它們。
  • 要還原: 關閉 Override OpenAI Base URL 即可。金鑰與模型項目可以保留。
  • 你也可以在 Cursor 中安裝 Claude Code 擴充套件(Cursor 接受 VS Code 市集)——見在 VS Code 裡使用。該路線走 Anthropic Messages 協議,不受限於 Chat / Plan。

疑難排解

現象原因與處理
Verify 失敗對非 OpenAI 模型名稱屬誤報——請在 Chat 中實測
401金鑰貼上不完整或已停用;請重新複製
404Override OpenAI Base URL 少了 /v1
Chat 中找不到新模型模型 ID 拼錯,或你沒有在 Chat 的模型下拉選單中切換到它
餘額不足(Insufficient balance)儲值