Hướng dẫn cấu hình Cursor với Beeknoee
Cursor là gì?
Cursor là code editor AI-first — fork từ VS Code với AI tích hợp sẵn, hỗ trợ chat, inline edit, và agent mode. Cursor cho phép cấu hình custom API endpoint tương thích OpenAI, giúp bạn sử dụng toàn bộ hơn 130 models trên Beeknoee.
💡 Beeknoee API tương thích hoàn toàn với OpenAI — Cursor nhận diện như OpenAI provider.
Yêu cầu
- Cursor IDE phiên bản mới nhất (cursor.com)
- Cursor Pro hoặc Business (cần để cấu hình custom API endpoint)
- API Key từ Beeknoee Platform
📌 Bước 1: Tạo API Key
- Truy cập https://platform.beeknoee.com/api-keys
- Đăng nhập bằng tài khoản Google
- Nhấn "Tạo API Key"
- Copy API Key (dạng
sk-bee-xxxx...)
⚠️ API key chỉ hiển thị 24 giờ đầu — copy và lưu ngay!
📌 Bước 2: Cài đặt Cursor
- Tải Cursor tại cursor.com
- Cài đặt và mở Cursor
- Đăng nhập tài khoản Cursor (cần Pro/Business)
📌 Bước 3: Cấu hình Beeknoee API
- Mở Cursor Settings:
Ctrl+Shift+J(Windows/Linux) hoặcCmd+Shift+J(macOS) - Chọn tab Models
- Tìm mục OpenAI API Key → nhập API key:
sk-bee-YOUR_API_KEY - Bật Override OpenAI Base URL → nhập:
https://platform.beeknoee.com/v1
-
Nhấn + Add Model → nhập đúng Model ID muốn sử dụng (copy chính xác
providerModelIdtừ trang Models trên Dashboard, ví dụdeepseek/deepseek-v3.2,claude-sonnet-...,gpt-5-...) -
Verify — nhấn nút test bên cạnh để kiểm tra kết nối
⚠️ Base URL phải kết thúc bằng
/v1:https://platform.beeknoee.com/v1
🔴 Giới hạn quan trọng của Cursor (cập nhật 2026): Khi bật "Override OpenAI Base URL", Cursor chỉ dùng endpoint tuỳ chỉnh cho khung Chat / Plan. Các tính năng Tab Autocomplete, Agent/Composer, Apply vẫn chạy qua backend riêng của Cursor (yêu cầu gói Cursor trả phí) và không đi qua Beeknoee. Nếu bạn muốn một trình soạn thảo dùng Beeknoee cho toàn bộ tác vụ, hãy cân nhắc cài extension Cline / Kilo Code / Continue (xem các hướng dẫn tương ứng).
🔴 Lỗi 422 với model Claude: Sau khi bật Override Base URL, Cursor vẫn cố gửi các model Claude theo định dạng riêng của Anthropic tới endpoint bạn đặt — trong khi Beeknoee nhận định dạng OpenAI ở đường này, nên trả về 422. Đây là hạn chế phía Cursor, không phải lỗi API key.
Cách tránh: trong Cursor, chỉ thêm và dùng các model không phải Claude (ví dụ
deepseek/deepseek-v3.2, các model GPT). Muốn dùng Claude qua Beeknoee, hãy dùng Claude Code (xem hướng dẫn) hoặc extension Cline / Kilo Code.
📌 Bước 4: Sử dụng
Phím tắt AI trong Cursor
| Phím tắt | Chức năng | Mô tả |
|---|---|---|
Ctrl+L | AI Chat | Mở panel chat với AI, hỏi về code |
Ctrl+K | Inline Edit | Chỉnh sửa code trực tiếp tại vị trí con trỏ |
Ctrl+I | Composer / Agent | Chỉnh sửa nhiều file, AI tự tìm và sửa |
Tab | Autocomplete | Chấp nhận gợi ý code từ AI |
Ví dụ sử dụng
- Bôi đen đoạn code →
Ctrl+L→ "Giải thích đoạn code này" - Đặt con trỏ →
Ctrl+K→ "Thêm error handling cho function này" Ctrl+I→ "Tạo component React mới với TypeScript và Tailwind CSS"
📌 Nâng cao: File .cursorrules
Tạo file .cursorrules ở thư mục root dự án để hướng dẫn AI hiểu project của bạn:
Tech stack: Next.js 14, TypeScript, Tailwind CSS, Prisma
Coding conventions:
- Use functional components with hooks
- Prefer named exports
- Use Vietnamese comments for business logic
- Always handle errors with try-catch
💡 File
.cursorrulesgiúp AI code đúng style và conventions của project bạn.
Models khuyên dùng với Cursor
| Nhóm model | Phù hợp cho |
|---|---|
| Claude Sonnet | Coding hàng ngày, chất lượng cao |
| Claude Opus | Task phức tạp, refactor lớn |
| GPT-5 flagship | Multimodal, đa năng |
| DeepSeek | Chi phí thấp, code tốt |
| Gemini Pro | Context lớn, phân tích tài liệu |
| GPT-5 Nano | Tab autocomplete (rẻ nhất) |
| GLM Flash | Bản miễn phí, testing/prototype |
💡 Model ID chính xác và giá realtime xem tại trang Models trên Dashboard.
⚠️ Đừng chọn model Beeknoee với ý định dùng cho Tab Autocomplete hay Composer — như đã nêu ở trên, hai tính năng đó chạy bằng backend riêng của Cursor, không đi qua Beeknoee. Model bạn thêm ở đây chỉ có tác dụng trong khung Chat / Plan.
🆓 Models miễn phí qua BeeSynapse
Khi đã kết nối email tại trang BeeSynapse Integrations, hệ thống tự động ưu tiên free quota:
| Nhóm model | Free qua |
|---|---|
| Claude (Opus / Sonnet) | Antigravity (Google Account) |
| Gemini (Pro / Flash) | Antigravity (Google Account) |
| GPT Codex series | Codex (OpenAI Account) |
| GLM Flash | Bản miễn phí trên Beeknoee |
Danh sách model free thay đổi theo quota nhà cung cấp — xem chính xác tại trang BeeSynapse Integrations. Bạn không cần thay đổi gì — Beeknoee tự route qua free quota trước, hết quota mới trừ VND.
Xử lý lỗi
"Could not verify API key"
- Kiểm tra API key bắt đầu bằng
sk-bee- - Kiểm tra key chưa bị thu hồi tại API Keys
"Model not found" hoặc không thấy model
- Kiểm tra Model ID chính xác tại trang Text Models
- Model ID phân biệt HOA-thường, ví dụ:
claude-sonnet-4-6✅,Claude-Sonnet-4.6❌
"Network error" hoặc "Connection refused"
- Kiểm tra Base URL đúng:
https://platform.beeknoee.com/v1 - Đảm bảo URL kết thúc bằng
/v1 - Kiểm tra kết nối internet
Cursor không dùng model Beeknoee
- Đảm bảo đã bật Override OpenAI Base URL
- Kiểm tra model đã được thêm vào danh sách Models trong Settings
- Chọn đúng model trong dropdown khi dùng Chat/Composer
HOÀN TẤT! 🎉
Cần hỗ trợ thêm? Sử dụng Support Chat (góc dưới phải trên platform) hoặc liên hệ qua email.
