Gunakan kunci Anda di Cursor
Aktifkan Override OpenAI Base URL, tambahkan model kustom, dan ketahui fitur Cursor mana yang masih memakai backend-nya sendiri.
Cursor mendukung bring-your-own-key (BYOK): setel base URL yang kompatibel dengan OpenAI plus kunci OLETOKEN Anda, dan permintaan dari Chat akan berjalan dengan saldo OLETOKEN Anda.
Sebelum memulai
- Anda sudah membuat kunci API dan menyimpan kunci lengkapnya.
- Anda sudah memiliki ID model dari pasar model.
- Build Cursor Anda mendukung model kustom (Settings → Models menampilkan tombol “Add Model”).
Konfigurasi
-
Buka pengaturan:
⌘⇧J(macOS) /Ctrl⇧J(Windows, Linux), atau⌘⇧P→Cursor Settings. -
Buka Models → Model Names → + Add Model, ketik ID model yang Anda inginkan lalu tekan Enter.
-
Di halaman yang sama, bagian API Keys → OpenAI API Key, klik + dan tempel kunci OLETOKEN Anda.
-
Nyalakan Override OpenAI Base URL dan masukkan alamat kompatibel OpenAI termasuk
/v1:https://<your-base-url>/v1Cursor menambahkan
/chat/completionske alamat itu, jadi/v1tidak opsional. -
Klik Verify. Untuk nama model yang bukan milik OpenAI sendiri, verifikasi bisa gagal — itu alarm palsu; uji dengan mengirim pesan di Chat saja.
-
Kembali di editor, tekan
⌘L/Ctrl+Luntuk membuka Chat dan pilih model Anda di dropdown model.
Yang perlu diketahui
- Hanya Chat dan Plan yang tercakup. Composer, Tab completion, dan Inline Edit masih berjalan di backend Cursor sendiri dan tidak memakai saldo OLETOKEN Anda.
- Model Anthropic bawaan Anda bisa terpengaruh. Saat Override OpenAI Base URL aktif, model Claude bawaan Cursor dapat ikut dialihkan ke situs ini. Jika Anda tetap ingin yang resmi, tambahkan ID model Claude sebagai model kustom dengan + Add Model lalu pilih model tersebut di dropdown.
- Untuk mengembalikannya: matikan Override OpenAI Base URL. Entri kunci dan model boleh tetap ada.
- Anda juga dapat memasang ekstensi Claude Code di Cursor (Cursor menerima marketplace VS Code) — lihat menggunakan VS Code. Jalur itu berbicara dengan protokol Anthropic Messages dan tidak terbatas pada Chat / Plan.
Penelusuran masalah
| Gejala | Penyebab dan solusi |
|---|---|
| Verify gagal | Alarm palsu untuk nama model non-OpenAI — uji di Chat |
| 401 | Kunci ditempel tidak lengkap atau dinonaktifkan; salin ulang |
| 404 | Override OpenAI Base URL tidak menyertakan /v1 |
| Model baru tidak muncul di Chat | ID model salah tulis, atau Anda belum beralih ke model itu di dropdown model Chat |
| Insufficient balance | Isi saldo terlebih dahulu |

