Cấu hình Cursor

1. Cursor là gì và cần chuẩn bị gì trước khi bắt đầu

Cursor là AI IDE dựa trên VS Code, có thể thực hiện chat, sinh mã, chỉnh sửa và giải thích ngay trong editor.

Trước khi tích hợp Cursor qua RouteAPI, nên chuẩn bị:

• Ứng dụng desktop Cursor đã cài đặt và đăng nhập bình thường
• Khóa RouteAPI của bạn
• Mô hình chat chuẩn giao thức OpenAI khả dụng trong console RouteAPI
• Địa chỉ OpenAI-compatible của RouteAPI: https://www.routeapi.ai/v1

Ghi chú tương thích chính thức

Theo tài liệu chính thức Cursor API Keys, nơi cấu hình API key tùy chỉnh nằm trong Cursor Settings > Models và được bật bằng Verify.

Đồng thời cần lưu ý:

• API key tùy chỉnh chỉ áp dụng cho mô hình chat chuẩn.
• Các tính năng như Tab Completion cần mô hình chuyên dụng vẫn tiếp tục dùng mô hình tích hợp của Cursor.
• OpenAI provider chỉ hỗ trợ mô hình chat chuẩn, không phải reasoning.

2. Cài đặt và mở thiết lập mô hình

Cài đặt và đăng nhập Cursor

Cài ứng dụng desktop từ trang chính thức của Cursor và đăng nhập bằng tài khoản Cursor của bạn.

Mở Cursor Settings > Models

Trong Cursor, mở trang Settings rồi vào Models.

3. Cấu hình RouteAPI

3.1 Điền thông tin truy cập của OpenAI provider

Trong trang Models, tìm mục cấu hình liên quan đến OpenAI. Tên trường có thể hơi khác tùy phiên bản Cursor, nhưng thông tin cốt lõi cần điền là:

• OpenAI API Key: khóa RouteAPI của bạn
• OpenAI Base URL: https://www.routeapi.ai/v1

Sau khi điền xong, nhấp Verify.

Tên trường có thể hơi khác

Một số phiên bản Cursor hiển thị trường địa chỉ là Base URL, OpenAI Base URL hoặc tên tương tự. Về bản chất, hãy điền địa chỉ OpenAI-compatible của RouteAPI: https://www.routeapi.ai/v1.

3.2 Chọn mô hình

Sau khi xác minh thành công, mở bộ chọn mô hình của Cursor và chọn mô hình OpenAI-compatible khả dụng do RouteAPI trả về.

Cách thận trọng hơn:

• Ưu tiên chọn mô hình chuẩn được console RouteAPI đánh dấu là giao thức OpenAI, phù hợp cho chat hoặc lập trình.
• Không ưu tiên mô hình reasoning, vì tài liệu chính thức Cursor nêu rõ API key OpenAI tùy chỉnh chỉ hỗ trợ mô hình chat chuẩn, không reasoning.

3.3 Bắt đầu sử dụng

Sau khi cấu hình xong, bạn có thể dùng trực tiếp mô hình do RouteAPI cung cấp trong Chat hoặc Composer của Cursor.

4. Lưu ý

• Phương án API key tùy chỉnh chủ yếu ảnh hưởng đến năng lực mô hình chat chuẩn như Chat / Composer, không thay thế toàn bộ năng lực tích hợp của Cursor.
• Nếu bạn bật Tab Completion, một số năng lực Agent hoặc tính năng khác cần mô hình chuyên dụng, Cursor vẫn có thể tiếp tục dùng mô hình sẵn có.
• Theo FAQ chính thức của Cursor, API key sẽ không được lưu trữ, nhưng mỗi yêu cầu vẫn được gửi đến máy chủ Cursor để hoàn tất việc lắp ráp prompt cuối cùng.

5. Xử lý sự cố thường gặp

• Khi Verify thất bại, trước tiên kiểm tra API key có đúng không và địa chỉ có phải https://www.routeapi.ai/v1 không.
• Nếu danh sách mô hình không xuất hiện mô hình mong muốn, hãy kiểm tra mô hình đó có hỗ trợ giao thức OpenAI và là mô hình chat chuẩn chứ không phải reasoning hay không.
• Nếu bạn đã cập nhật key hoặc địa chỉ nhưng Cursor vẫn hiển thị trạng thái cũ, hãy đóng rồi mở lại Cursor và Verify lại.
• Nếu cần cách tích hợp agent lập trình trong terminal, cũng có thể tham khảo tài liệu cấu hình Codex, tài liệu cấu hình Claude và tài liệu cấu hình OpenCode.