Trae + JoinGonka Gateway — các mô hình mạng Gonka trong AI-IDE

Bản dựng và phiên bản. Trae có hai nhánh: quốc tế (tài liệu tại docs.trae.ai) và Trung Quốc (docs.trae.cn). Tùy chọn Custom Model có mặt ở cả hai và hoạt động như nhau; điểm khác biệt nằm ở các mô hình tích hợp và bộ cài đặt trước trong các cài đặt bổ sung. Địa chỉ yêu cầu tùy chỉnh cho mô hình riêng được hỗ trợ từ phiên bản 3.5.51 ngày 14 tháng 4 năm 2026 — nếu bản dựng của bạn cũ hơn, hãy cập nhật. Bản dựng quốc tế không khả dụng ở tất cả các quốc gia: trước khi cài đặt, hãy kiểm tra danh sách các quốc gia và khu vực được hỗ trợ.

Hệ thống. macOS 12 trở lên, Windows 10 hoặc 11 (x64), Linux trong các gói .deb và .rpm. Khi khởi chạy lần đầu, Trae sẽ đề nghị chọn giao diện và ngôn ngữ, nhập cài đặt từ VS Code hoặc Cursor và đăng nhập vào tài khoản.

Khóa JoinGonka. Đăng ký trên cổng gateway, mở phần “API-keys” trong bảng điều khiển và nhấn “Create key”. Khóa bắt đầu bằng jg- và chỉ được hiển thị một lần — hãy lưu nó ngay lập tức. Việc tạo một khóa riêng cho Trae rất thuận tiện: trong phần “Usage”, mức sử dụng của nó sẽ được hiển thị thành một dòng riêng.

Gói cước Trae. Bạn phải chọn mô hình riêng theo cách thủ công trong danh sách, và trong bảng giá cước của Trae, gói miễn phí trong dòng chọn mô hình chỉ có chế độ Auto — trong chế độ này, các mô hình riêng không được sử dụng. Tài liệu không nói rõ liệu hạn chế này có áp dụng cho các mô hình được thêm bằng khóa riêng hay không. Quy tắc thực tế rất đơn giản: nếu trong gói của bạn, Auto Mode trong danh sách mô hình có thể tắt, thì mọi thứ đã sẵn sàng; nếu không — bạn sẽ cần gói trả phí.

1. Mở Settings → Models — bảng điều khiển quản lý model.
2. Nhấn Add Model. Trong cửa sổ hiện ra, chọn Custom Model thay vì chọn nhà cung cấp từ danh sách có sẵn.
3. Điền các trường theo giá trị trong bảng. Có hai cột — tương ứng với từng định dạng API; hãy chọn một.
4. Nhấn Add Model. Trae sẽ gọi thử API và kiểm tra key: nếu thành công, model sẽ xuất hiện trong danh sách; nếu thất bại, cửa sổ sẽ hiển thị thông báo lỗi và log phản hồi từ nhà cung cấp.

Các trường còn lại không phụ thuộc vào định dạng:

Nên chọn định dạng nào. Hãy bắt đầu với OpenAI Chat Completions: đây là đường chính của gateway, hầu hết công cụ đều hoạt động với nó. Anthropic Messages sẽ hữu ích nếu bạn đã quen với định dạng này ở các công cụ khác hoặc muốn so sánh hành vi của agent trên hai giao thức — key và số dư dùng chung.

Full URL hoạt động thế nào. Công tắc quyết định ai sẽ nối thêm đường dẫn. Tắt — bạn cung cấp địa chỉ gốc, còn Trae sẽ thêm đường dẫn theo định dạng đã chọn: /chat/completions vào địa chỉ có /v1 cho OpenAI và /v1/messages vào gốc cho Anthropic. Bật — địa chỉ được dùng nguyên vẹn, và đường dẫn phải có đầy đủ trong đó. Lỗi phổ biến nhất là trộn lẫn các chế độ: nhập đường dẫn đầy đủ khi công tắc tắt hoặc nhập địa chỉ gốc khi công tắc bật.

Một mục — một model. Lặp lại các bước cho những model khác của mạng để chuyển đổi giữa chúng mà không cần quay lại phần cài đặt: deepseek-ai/DeepSeek-V4-Flash-0731, MiniMaxAI/MiniMax-M2.7 và zai-org/GLM-5.3-Flash. Danh sách mới nhất được trả về bởi GET https://gate.joingonka.ai/v1/models. Model đã thêm sau đó có thể chỉnh sửa, tắt (nó vẫn ở trong bảng điều khiển nhưng biến mất khỏi danh sách trong chat) hoặc xóa.

Bên dưới các trường chính có danh sách thu gọn Advanced Settings. Bạn có thể không cần thay đổi — Trae sẽ tự điền các giá trị mặc định — nhưng có hai cài đặt đáng được chú ý: model series và context window.

Giá của các mô hình trong mạng là như nhau, vì vậy việc lựa chọn phụ thuộc vào hành vi. Tất cả các mô hình trong bảng đều hỗ trợ tool calling gốc, đây là nền tảng hoạt động của các tác nhân Trae.

Cách thức hoạt động của ngân sách suy luận và lý do tại sao không nên giảm giới hạn đầu ra của các mô hình suy luận được giải thích trong đánh giá GLM-5.3 Flash; so sánh các mô hình trên các tác vụ lập trình — trong bài viết về các mô hình tốt nhất cho code.

Các mô hình của riêng bạn nằm trong danh sách chung: nhấp vào tên mô hình hiện tại ở góc dưới bên phải của khung nhập trò chuyện và chọn mô hình đã thêm. Tại đó cũng có công tắc Auto Mode — nó phải được tắt: ở chế độ Auto, Trae tự chọn mô hình từ các mô hình tích hợp sẵn và không sử dụng các mô hình do bạn thêm vào.

Giao cho tác nhân một nhiệm vụ cần công cụ, ví dụ: "Đọc package.json và liệt kê các tập lệnh xây dựng". Tác nhân phải mở tệp và phản hồi đúng trọng tâm — điều đó có nghĩa là vòng lặp "yêu cầu — gọi công cụ — phản hồi" thông qua cổng kết nối (gateway) đã được thiết lập. Sau đó, hãy mở bảng điều khiển của cổng kết nối, mục "Sử dụng" (Usage): trong khối "Theo khóa" (By keys), các yêu cầu và thời gian truy cập cuối cùng sẽ xuất hiện cho khóa Trae, còn trong khối "Theo mô hình" (By models) sẽ là mô hình đã chọn.

Nếu có gì đó không ổn, hãy xem văn bản lỗi. Trae không ẩn câu trả lời của mô hình của riêng bạn: nó hiển thị lỗi của nhà cung cấp như nguyên trạng, với mã nội bộ 4028.

Tác nhân trong IDE tiêu tốn token nhanh hơn trò chuyện: mỗi yêu cầu đều bao gồm các hướng dẫn hệ thống, mô tả công cụ, các tệp đang mở và lịch sử các bước. Do đó, giá mỗi token xác định xem bạn có thể chạy tác nhân cho mọi việc nhỏ nhặt hay phải tiết kiệm.

Thông qua JoinGonka Gateway, token có giá $0.0069 mỗi triệu token đầu vào và $0.021 mỗi triệu token đầu ra — giá giống nhau cho tất cả các mô hình trong mạng và được cập nhật trên trang này từ nguồn trực tiếp. Thứ tự số tiền dựa trên giá tháng 9 năm 2026:

Việc so sánh với chính Trae rất trực quan, vì các mô hình mở cũng nằm trong số các mô hình tích hợp sẵn, và Trae công bố bảng giá của họ cho mỗi triệu token. DeepSeek-V4-Flash và MiniMax-M2.7 có giá ở đó là $0.30 đầu vào và $1.20 đầu ra, còn GLM-5.3 Flash không hề có trong danh sách tích hợp sẵn của bản dựng quốc tế. Thông qua cổng kết nối, sự khác biệt đối với cùng các mô hình đó là khoảng ×43 đầu vào và ×58 đầu ra.

Mô hình của riêng bạn hoạt động ở bất cứ nơi nào có danh sách mô hình. Đây là tính năng trò chuyện và tác nhân — cả ở chế độ IDE và SOLO (các mô hình riêng được hỗ trợ từ phiên bản 3.3.0). Tự động hoàn thành và dự đoán chỉnh sửa là một cơ chế riêng biệt CUE với bảng cài đặt riêng: nó không có tùy chọn chọn mô hình và các giới hạn của nó được đặt bởi gói cước Trae.

Công cụ và MCP. Các tác nhân Trae đóng vai trò là khách hàng MCP và các máy chủ bạn đã kết nối vẫn khả dụng cho tác nhân trên mô hình riêng của nó: tất cả các mô hình trong mạng hỗ trợ gọi công cụ gốc. Nếu Trae thông báo rằng sơ đồ đối số của công cụ không tương thích với mô hình (mã 4027), hãy thử một mô hình lân cận trong mạng hoặc một máy chủ MCP khác.

TraeWork. Trong ứng dụng TraeWork riêng biệt, biểu mẫu thêm mô hình riêng của bạn giống hệt nhau, nhưng theo tài liệu, nó chỉ hoạt động trong TraeWork Desktop và chỉ dành cho các tác vụ trong môi trường cục bộ.

Plugin cho các trình soạn thảo khác. Trong tài liệu của plugin TraeCode cho VS Code và JetBrains, không có phần nào nói về các mô hình riêng — hướng dẫn này áp dụng cho IDE để bàn. Nếu bạn vẫn sử dụng VS Code, cổng tương tự được kết nối thông qua các phần mở rộng tác nhân, ví dụ như Cline.

Quyền riêng tư. Cài đặt Privacy Mode (Settings → Account) kiểm soát những gì Trae làm với các cuộc hội thoại và đoạn mã của bạn: với chế độ này, chúng không được gửi đến phân tích và đào tạo. Về phía cổng gateway, các cuộc hội thoại không được lưu trữ: các câu lệnh (prompt) và phản hồi không còn lại trên đó sau khi trả lời, trong bảng điều khiển chỉ hiển thị số lượng yêu cầu và token.

Nếu cần làm việc với hình ảnh — bản thiết kế, ảnh chụp màn hình lỗi — hãy giao nhiệm vụ đó cho mô hình tích hợp có khả năng thị giác, còn mã, lệnh và tệp hãy để cho mô hình mạng: việc chuyển đổi chỉ mất một cú nhấp chuột trong danh sách mô hình.