在 Cursor 裡使用
開啟 Override OpenAI Base URL、新增自訂模型,並了解哪些 Cursor 功能仍走官方後端。
Cursor 支援自備金鑰(BYOK):設定一組 OpenAI 相容的 base URL 加上你的 OLETOKEN 金鑰,Chat 的請求就會改由你的 OLETOKEN 餘額支付。
開始之前
設定
-
開啟設定:
⌘⇧J(macOS)/Ctrl⇧J(Windows、Linux),或⌘⇧P→Cursor Settings。 -
前往 Models → Model Names → + Add Model,輸入你要用的模型 ID 後按 Enter。
-
在同一頁的 API Keys → OpenAI API Key 下方點 +,貼上你的 OLETOKEN 金鑰。
-
開啟 Override OpenAI Base URL,填入 OpenAI 相容位址,要包含
/v1:https://<your-base-url>/v1Cursor 會在其後接上
/chat/completions,因此/v1不能省略。 -
點 Verify。對於非 OpenAI 自家的模型名稱,驗證可能失敗——那是誤報;請直接在 Chat 中送訊息實測。
-
回到編輯器按
⌘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 | 金鑰貼上不完整或已停用;請重新複製 |
| 404 | Override OpenAI Base URL 少了 /v1 |
| Chat 中找不到新模型 | 模型 ID 拼錯,或你沒有在 Chat 的模型下拉選單中切換到它 |
| 餘額不足(Insufficient balance) | 先儲值 |

