Dùng khóa của bạn trong Cursor

Cursor hỗ trợ mang khóa của riêng bạn (BYOK): đặt một base URL tương thích OpenAI cùng khóa OLETOKEN của bạn, và các yêu cầu từ Chat sẽ chạy trên số dư OLETOKEN của bạn.

Trước khi bắt đầu

1. Bạn đã tạo khóa API và lưu lại khóa đầy đủ.
2. Bạn đã có một model ID từ chợ mô hình.
3. Bản Cursor của bạn hỗ trợ mô hình tùy chỉnh (Settings → Models có nút "Add Model").

Cấu hình

1. Mở cài đặt: ⌘⇧J (macOS) / Ctrl⇧J (Windows, Linux), hoặc ⌘⇧P → Cursor Settings.

2. Vào Models → Model Names → + Add Model, gõ model ID bạn muốn rồi nhấn Enter.

3. Cũng trên trang đó, ở mục API Keys → OpenAI API Key, bấm + và dán khóa OLETOKEN của bạn.

4. Bật Override OpenAI Base URL và nhập địa chỉ tương thích OpenAI bao gồm /v1:

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

   Cursor sẽ nối thêm /chat/completions vào đó, nên /v1 không phải là tùy chọn.

5. Bấm Verify. Với những tên mô hình không phải của OpenAI, bước xác minh có thể thất bại — đó là báo động nhầm; hãy gửi một tin nhắn trong Chat để kiểm tra thay vì tin vào kết quả đó.

6. Quay lại trình soạn thảo, nhấn ⌘L / Ctrl+L để mở Chat và chọn mô hình của bạn trong danh sách thả xuống.

Những điều cần biết

• Chỉ Chat và Plan được áp dụng. Composer, gợi ý Tab completion và Inline Edit vẫn chạy trên backend riêng của Cursor và không tiêu số dư OLETOKEN của bạn.
• Các mô hình Anthropic tích hợp của bạn có thể bị ảnh hưởng. Khi bật Override OpenAI Base URL, các mô hình Claude đi kèm của Cursor cũng có thể bị định tuyến về trang này. Nếu vẫn muốn dùng bản chính thức, hãy thêm các model ID Claude đó thành mô hình tùy chỉnh bằng + Add Model rồi chọn chúng trong danh sách thả xuống.
• Để khôi phục: tắt Override OpenAI Base URL. Các mục khóa và mô hình có thể giữ nguyên.
• Bạn cũng có thể cài tiện ích Claude Code trong Cursor (Cursor chấp nhận chợ tiện ích của VS Code) — xem dùng VS Code. Hướng đó nói giao thức Anthropic Messages và không bị giới hạn ở Chat / Plan.

Xử lý sự cố