Gunakan kunci anda dalam Cursor

Ganti Base URL OpenAI, tambah model tersuai, dan ketahui ciri Cursor mana yang masih menggunakan bahagian belakangnya sendiri.

Cursor menyokong bawa-kunci-anda-sendiri (BYOK): tetapkan base URL serasi OpenAI serta kunci OLETOKEN anda, dan permintaan daripada Chat akan berjalan menggunakan baki OLETOKEN anda.

Sebelum bermula

Anda telah mencipta kunci API dan menyimpan kunci penuh tersebut.
Anda mempunyai ID model daripada pasaran model.
Binaan Cursor anda menyokong model tersuai (Settings → Models memaparkan butang “Add Model”).

Konfigurasi

Buka tetapan: ⌘⇧J (macOS) / Ctrl⇧J (Windows, Linux), atau ⌘⇧P → Cursor Settings.
Pergi ke Models → Model Names → + Add Model, taip ID model yang anda mahu dan tekan Enter.
Pada halaman yang sama, di bawah API Keys → OpenAI API Key, klik + dan tampal kunci OLETOKEN anda.
Hidupkan Override OpenAI Base URL dan masukkan alamat serasi OpenAI termasuk /v1:
```
https://<your-base-url>/v1
```
Cursor menambahkan /chat/completions padanya, jadi /v1 bukan pilihan.
Klik Verify. Bagi nama model yang bukan milik OpenAI sendiri, pengesahan mungkin gagal — itu amaran palsu; hantar mesej dalam Chat untuk mengujinya sebaliknya.
Kembali ke editor dan tekan ⌘L / Ctrl+L untuk membuka Chat dan pilih model anda dalam menu lungsur model.

Baik untuk diketahui

Hanya Chat dan Plan diliputi. Composer, pelengkapan Tab dan Inline Edit masih berjalan pada bahagian belakang Cursor sendiri dan tidak membelanjakan baki OLETOKEN anda.
Model Anthropic terbina dalam anda mungkin terjejas. Dengan Override OpenAI Base URL dihidupkan, model Claude yang dibundelkan bersama Cursor boleh turut dihalakan ke laman ini. Jika anda masih mahu yang rasmi, tambahkan ID model Claude sebagai model tersuai dengan + Add Model dan pilih yang tersebut dalam menu lungsur.
Untuk memulihkan semula: matikan Override OpenAI Base URL. Entri kunci dan model boleh dibiarkan.
Anda juga boleh memasang sambungan Claude Code dalam Cursor (Cursor menerima pasaran VS Code) — lihat menggunakan VS Code. Laluan itu bertutur dalam protokol Anthropic Messages dan tidak terhad kepada Chat / Plan.

Penyelesaian masalah

Simptom	Punca dan penyelesaian
Verify gagal	Amaran palsu bagi nama model bukan OpenAI — uji dalam Chat
401	Kunci ditampal secara tidak lengkap atau dilumpuhkan; salin semula
404	Override OpenAI Base URL tidak mempunyai `/v1`
Model baharu tiada dalam Chat	ID model tersalah eja, atau anda tidak bertukar kepadanya dalam menu lungsur model Chat
Insufficient balance	Tambah nilai dahulu