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

> Kết nối LLMoxy qua mô hình tùy chỉnh trong Trae IDE của ByteDance, dùng Chat / Builder để lập trình với Agent.

Trang web: [https://www.trae.cn (Trung Quốc)](https://www.trae.cn) · [https://www.trae.ai (quốc tế)](https://www.trae.ai)

Trae (đọc là /treɪ/) là IDE AI của ByteDance, dựa trên VS Code, tích hợp sẵn Chat và Builder. Ngoài các mô hình tích hợp, bạn có thể dùng cấu hình tùy chỉnh để chuyển yêu cầu sang LLMoxy.

Trước khi bắt đầu, hãy chuẩn bị một [mã thông báo LLMoxy](https://vi.llmoxy.com/docs/get-started/get-token), nên dùng nhóm **auto**.

## Cài đặt

1. Mở trang web chính thức, tải tệp `.exe` hoặc `.dmg` theo hệ điều hành (Apple Silicon chọn ARM).
2. Lần khởi động đầu tiên, chọn giao diện và ngôn ngữ Tiếng Trung giản thể.
3. Tùy chọn: nhập plugin, phím tắt và cài đặt từ VS Code hoặc Cursor.
4. Nên cài dòng lệnh `trae`, sau đó có thể dùng `trae .` để mở thư mục hiện tại.

![Tải Trae](https://vi.llmoxy.com/docs-assets/migrated/tutorial-trae/download.png)

![Nhập từ VS Code / Cursor](https://vi.llmoxy.com/docs-assets/migrated/tutorial-trae/import.webp)

## Kết nối LLMoxy

1. Mở **Settings → Models**.
2. Nhấp **Add Model**.
3. Chọn mục trên cùng **Custom Model** (đừng chọn các nhà cung cấp định sẵn như DeepSeek, Alibaba Cloud).
4. Điền theo bảng dưới rồi nhấp thêm. Trae sẽ dò xem khóa có hợp lệ không trước.

![Mở quản lý mô hình](https://vi.llmoxy.com/docs-assets/migrated/tutorial-trae/models.png)

![Chọn mô hình tùy chỉnh](https://vi.llmoxy.com/docs-assets/migrated/tutorial-trae/add-model.webp)

**Dùng chế độ tương thích OpenAI (khuyến nghị, GPT / Gemini / đa số mô hình):**

| Trường | Điền |
| --- | --- |
| Định dạng API | OpenAI Chat Completions |
| Địa chỉ yêu cầu tùy chỉnh | `https://llmoxy.com/v1` |
| URL đầy đủ | **Tắt** |
| ID mô hình | Ví dụ `grok-4.7` |
| Khóa API | Mã thông báo LLMoxy |

**Dùng chế độ tương thích Anthropic (dòng Claude):**

| Trường | Điền |
| --- | --- |
| Định dạng API | Anthropic Messages |
| Địa chỉ yêu cầu tùy chỉnh | `https://llmoxy.com` |
| URL đầy đủ | **Tắt** |
| ID mô hình | Ví dụ `claude-opus-5-5`, `claude-fable-5-2` |
| Khóa API | Mã thông báo LLMoxy |

> **💡 Mẹo**
> "URL đầy đủ" mặc định được tắt. Sau khi bật thì phải điền đường dẫn đầy đủ, ví dụ `https://llmoxy.com/v1/chat/completions`. Với GPT-5 / GPT-6, nên chọn "dòng mô hình" tương ứng trong cấu hình nâng cao, Trae sẽ tự điều chỉnh các trường yêu cầu.

Sau khi thêm thành công, tắt Auto ở góc dưới bên phải khung nhập hội thoại, rồi chọn mô hình vừa thêm trong danh sách.

## Cách dùng

Bên phải là bảng AI:

- **Chat**: giải thích mã, tìm lỗi, dùng `@tên tệp` để đưa ngữ cảnh vào câu hỏi.
- **Builder**: dựng dự án từ đầu bằng ngôn ngữ tự nhiên, sẽ tạo tệp, cài phụ thuộc và chạy xem trước.

![Chat và Builder](https://vi.llmoxy.com/docs-assets/migrated/tutorial-trae/assistant.png)

| Thao tác | macOS | Windows |
| --- | --- | --- |
| Chấp nhận thay đổi của tệp hiện tại | `Command + Enter` | `Ctrl + Enter` |
| Từ chối thay đổi của tệp hiện tại | `Command + Backspace` | `Ctrl + Backspace` |
| Hội thoại nội tuyến | `Command + I` | `Ctrl + I` |

Cũng tương thích với plugin VS Code. Nếu quen dùng Cline hơn, xem [Hướng dẫn plugin Trae Cline](https://vi.llmoxy.com/docs/code-tutorials/trae-cline).

## Câu hỏi thường gặp

**Địa chỉ yêu cầu tùy chỉnh luôn báo đỏ**
Trước hết xác nhận "URL đầy đủ" đang tắt, địa chỉ điền `https://llmoxy.com/v1` (OpenAI) hoặc `https://llmoxy.com` (Anthropic). Đừng nối `/chat/completions` vào địa chỉ cơ sở.

**Dò khóa thất bại**
Kiểm tra mã thông báo không có khoảng trắng, nhóm là **auto**, ID mô hình trùng khớp hoàn toàn với bảng điều khiển.

**Builder báo lỗi terminal trên Windows**
Vào Settings → Terminal Profile, chọn PowerShell 6 trở lên.

Đây là bản markdown của https://vi.llmoxy.com/docs/code-tutorials/trae.
