Hướng dẫn cấu hình IDE

Cursor IDE

Cấu hình Cursor dùng Premium Shop làm OpenAI-compatible backend.

Bạn cần: Cursor đã cài; custom OpenAI API/model có thể yêu cầu Cursor Pro hoặc Business.

Thông tin dùng chung

Secret đầy đủ có dạng sk_shop_....<secret> và chỉ hiện một lần.

Base URL: https://api.premiumshop.tech/v1
API key: sk_shop_....<secret>
Model: gpt-5.6-luna

Mở Models Settings

Ctrl+Shift+J trên Windows/Linux hoặc Cmd+Shift+J trên macOS, rồi chọn Models.

Thêm model

Add New Model và nhập id model.

Thêm modelconfig

gpt-5.6-luna

Nhập cấu hình

Chọn OpenAI/OpenAI-compatible, nhập key và override base URL.

Nhập cấu hìnhconfig

Provider: OpenAI Compatible
OpenAI API Key: sk_shop_....<secret>
Override OpenAI Base URL: https://api.premiumshop.tech/v1

Phím tắt

Chat Ctrl/Cmd+L, Inline Edit Ctrl/Cmd+K, Composer Ctrl/Cmd+I, nhận autocomplete bằng Tab.

.cursorrules

Thêm rule ngắn để Cursor hiểu quy ước dự án.

.cursorrulesconfig

## Tech Stack
- React + TypeScript
- Tailwind CSS

## Coding Conventions
- Follow existing project patterns
- Use Vietnamese for UI text when app uses Vietnamese
- Keep API keys out of git

Kiểm tra sau khi cấu hình

Gửi một yêu cầu ngắn, kiểm tra lượt gọi mới trong trang quản lý và xác nhận mã model phù hợp với gói của bạn.

Xử lý lỗi thường gặp

Model không hiện: kiểm tra chính xác mã model và khởi động lại Cursor.
Request failed: kiểm tra base URL kết thúc bằng /v1.
403 hoặc hết hạn mức: kiểm tra gói đang hoạt động.