> ## Documentation Index
> Fetch the complete documentation index at: https://docs.4096bytes.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor

> Cấu hình mô hình 4096bytes tùy chỉnh trong Cursor

Cursor có thể kết nối với 4096bytes bằng cấu hình tương thích OpenAI. Sau khi cấu hình, bạn có thể chọn mô hình 4096bytes trong Cursor Chat hoặc Agent.

<Warning>
  API Key tùy chỉnh trong Cursor thường chỉ ảnh hưởng đến mô hình bạn chọn trong Chat hoặc Agent. Cursor Tab, gợi ý hoàn thành, lập chỉ mục và tác vụ nền vẫn có thể dùng dịch vụ của Cursor. Phạm vi cụ thể phụ thuộc vào phiên bản Cursor.
</Warning>

## Điều kiện trước

* Bạn đã hoàn thành [Tạo tài khoản](/vi/quickstart/create-account).
* Bạn đã hoàn thành [Lấy API Key](/vi/quickstart/get-api-key).
* Cursor đã được cài và **Settings** mở bình thường.
* Bạn đã có API Key, Base URL và tên mô hình của 4096bytes.

Nên tạo API Key riêng cho Cursor, ví dụ `cursor-desktop` hoặc `cursor-work`.

## Cài đặt

Nếu chưa cài Cursor, mở [trang tải Cursor](https://cursor.com/downloads) và chọn gói cho macOS, Windows hoặc Linux.

<Steps>
  <Step title="Tải bộ cài">
    Chọn gói phù hợp với máy. Trên macOS cần phân biệt Apple Silicon và Intel. Trên Windows cần phân biệt x64 và ARM64.
  </Step>

  <Step title="Khởi động Cursor">
    Sau khi cài, mở Cursor một lần và xác nhận trình soạn thảo khởi động bình thường.
  </Step>

  <Step title="Mở cài đặt">
    Vào **Settings** và xác nhận có trang liên quan đến mô hình, AI hoặc Provider trước khi tiếp tục.
  </Step>
</Steps>

## Mở cài đặt mô hình

<Steps>
  <Step title="Mở Cursor Settings">
    Trong Cursor, mở **Settings**. Vị trí thường gặp là biểu tượng bánh răng góc dưới bên trái, **Cursor Settings** trong command palette hoặc menu **Cursor > Settings**.
  </Step>

  <Step title="Vào trang mô hình">
    Mở **Models**, **AI** hoặc trang liên quan đến Provider. Tìm các mục OpenAI API Key, custom API hoặc Override Base URL.
  </Step>

  <Step title="Bật cấu hình tương thích OpenAI">
    Nếu có công tắc, bật OpenAI API Key hoặc custom OpenAI settings. 4096bytes được điền theo kiểu Provider tương thích OpenAI.
  </Step>
</Steps>

## Điền thông tin kết nối

| Trường Cursor                          | Giá trị                                          |
| -------------------------------------- | ------------------------------------------------ |
| `OpenAI API Key`, `API Key`            | API Key bạn tạo trong bảng điều khiển 4096bytes. |
| `Override OpenAI Base URL`, `Base URL` | `https://api.4096bytes.com`.                     |
| `Model name`, `Custom model`           | Tên mô hình hiển thị trong bảng điều khiển.      |

Chỉ điền Base URL gốc. Không tự thêm `/v1/chat/completions`, `/v1/responses` hoặc đường dẫn endpoint đầy đủ khác.

<Warning>
  API Key sẽ được lưu trong cấu hình Cursor cục bộ. Không cấu hình key cá nhân trên máy dùng chung và không gửi ảnh chụp có lộ key.
</Warning>

## Thêm tên mô hình

<Steps>
  <Step title="Thêm mô hình tùy chỉnh">
    Trong danh sách mô hình của Cursor, nhấn **Add model**, **Add custom model** hoặc nút tương tự.
  </Step>

  <Step title="Nhập tên mô hình">
    Nhập tên mô hình được hiển thị trong bảng điều khiển. Tên phải khớp hoàn toàn, bao gồm chữ hoa/thường, dấu gạch nối và số phiên bản.
  </Step>

  <Step title="Lưu cài đặt">
    Lưu API Key, Base URL và tên mô hình. Nếu Cursor có nút **Verify** hoặc nút kiểm tra, hãy chạy thử.
  </Step>
</Steps>

## Chọn và kiểm tra mô hình

Sau khi lưu, mở Cursor Chat hoặc Agent và chọn mô hình 4096bytes trong bộ chọn mô hình.

Bạn có thể gửi yêu cầu rủi ro thấp:

```text theme={null}
Mô tả mục đích của dự án hiện tại trong một câu. Không sửa bất kỳ tệp nào.
```

Nếu mô hình trả lời bình thường, Cursor đã có thể gửi yêu cầu qua 4096bytes.

## Gợi ý sử dụng

* Tạo API Key riêng cho Cursor.
* Lần đầu cấu hình nên thử bằng câu hỏi ngắn để xác nhận mô hình, key và Base URL đều đúng.
* Nếu cấu hình nhiều Provider, kiểm tra mô hình đang chọn trước khi gửi.
* Với nhóm, nên cấp key riêng cho từng người hoặc từng thiết bị để dễ tra cứu tiêu thụ.

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

<AccordionGroup>
  <Accordion title="Không thấy mô hình mới trong Cursor">
    Xác nhận mô hình đã được thêm vào danh sách và khởi động lại Cursor. Một số phiên bản chỉ làm mới bộ chọn sau khi mở lại Chat.
  </Accordion>

  <Accordion title="Báo model not found">
    Sao chép lại tên mô hình từ bảng điều khiển, kiểm tra khoảng trắng thừa, lỗi chữ hoa/thường hoặc thiếu số phiên bản.
  </Accordion>

  <Accordion title="Xác thực thất bại">
    Kiểm tra API Key có đầy đủ không. Xác nhận bạn không dán key cũ, key đã xóa hoặc key có xuống dòng.
  </Accordion>

  <Accordion title="Sai địa chỉ yêu cầu">
    Base URL điền `https://api.4096bytes.com`. Không điền đường dẫn endpoint đầy đủ và không sao chép định dạng địa chỉ của ứng dụng khác.
  </Accordion>

  <Accordion title="Cursor vẫn dùng mô hình chính thức">
    Trong Chat hoặc Agent, hãy chọn thủ công mô hình 4096bytes. API Key tùy chỉnh không nhất thiết áp dụng cho mọi chức năng nội bộ của Cursor.
  </Accordion>

  <Accordion title="Cấu hình có vẻ đúng nhưng yêu cầu vẫn lỗi">
    Kiểm tra số dư, hạn mức key, mô hình có khả dụng trong nhóm hiện tại không và mạng có truy cập được `https://api.4096bytes.com` không.
  </Accordion>
</AccordionGroup>