Tài liệu

Roo Code

Nhà cung cấp OpenAI Compatible của Roo Code gồm ba trường và một khối cấu hình khả năng của mô hình. Khối khả năng này không phải phần trang trí tùy chọn — Roo Code dùng thông tin đó để tính toán hạn mức ngữ cảnh.

Chọn nhà cung cấp OpenAI Compatible, dán base URL và key, rồi đặt context window và max output của model để tính ngân sách của Roo Code chính xác.

Bảng cài đặt Roo Code

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...
Model          claude-sonnet-5

Model Configuration
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on

Roo Code sử dụng tính năng gọi công cụ native mà không có phương án dự phòng, vì vậy mô hình bạn chọn phải hỗ trợ gọi công cụ tương thích với OpenAI. Mọi id trong bảng bên dưới đều đáp ứng yêu cầu này; nếu cấu hình mô hình chỉ có văn bản hoặc đa phương tiện ở đây, mô hình sẽ lỗi khi tác tử thử dùng công cụ đầu tiên chứ không phải trong lúc thiết lập.

Hãy điền Context Window và Max Output Tokens thay vì để nguyên giá trị mặc định. Roo Code dựa vào các con số đó để quyết định thời điểm rút gọn cuộc hội thoại; vì vậy, cửa sổ ngữ cảnh đặt quá thấp sẽ khiến ứng dụng cắt bớt lịch sử dù không cần phải làm vậy, còn đặt quá cao sẽ gây lỗi 400 từ máy chủ thượng nguồn thay vì rút gọn hội thoại một cách gọn gàng.

Chưa có khóa? Tạo tài khoản Kunavo, tạo khóa (bắt đầu bằng sk-kn-) và nạp tín dụng từ $10 — các lệnh gọi được thanh toán từ số dư đó và các lệnh gọi thất bại không bị tính phí. Sau đó, bảng điều khiển mở tại phần thiết lập Roo Code.

Từng bước

Tạo khóa tại /app/keys rồi sao chép khóa — khóa chỉ hiển thị một lần.
Mở bảng cài đặt Roo Code và đặt API Provider thành OpenAI Compatible.
Nhập Base URL https://api.kunavo.com/v1 và khóa của bạn. Hậu tố /v1 phải nằm trong URL cơ sở — Roo Code chỉ nối thêm tuyến.
Chọn hoặc nhập id mô hình, sau đó mở Model Configuration và đặt cửa sổ ngữ cảnh, số token đầu ra tối đa, khả năng hỗ trợ hình ảnh và giá đầu vào/đầu ra theo bảng bên dưới.
Gửi tin nhắn trong Code mode. Giá nhập ở đây được Roo Code dùng trong phần hiển thị chi phí cho từng tác vụ, vì vậy cần nhập chính xác.

Đã kiểm tra đối chiếu với trang nhà cung cấp OpenAI Compatible của Roo Code vào 6 tháng 9, 2026. Cài đặt của bên thứ ba có thể thay đổi; nếu tên trường ở đây không còn khớp với những gì bạn thấy, trang đó là nguồn có thẩm quyền, không phải trang này.

Đây là phiên bản ngắn. Hướng dẫn đầy đủ — lựa chọn mô hình, chi phí của một phiên thực tế và các trường hợp lỗi — nằm trong hướng dẫn Roo Code + Claude.

Xác minh trước khi gỡ lỗi ứng dụng khách

Một yêu cầu sẽ xác định liệu lỗi nằm ở endpoint, khóa hay tệp cấu hình. Nếu lệnh này trả về JSON, cùng base URL và khóa sẽ hoạt động trong Roo Code.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Đặt model id nào vào trường

Mọi mô hình văn bản đều có thể truy cập bằng model id — danh sách đang hoạt động là GET /v1/models, còn danh mục kèm giá nằm trên trang mô hình. Mức giá tính bằng USD trên mỗi 1M token, đầu vào / đầu ra.

ID mô hình	Kunavo vào / ra	Phù hợp ở đâu trong Roo Code
`claude-sonnet-5`	$1.40 / $7.00	Code mode — chế độ mặc định, và là chế độ mà phần hiển thị chi phí được hiệu chỉnh theo
`claude-opus-5`	$3.50 / $17.50	Architect mode, nơi một kế hoạch sai khiến bạn tốn nhiều hơn số token
`claude-haiku-4-5`	$0.70 / $3.50	Ask mode và các lần đọc tệp lặp lại
`gpt-5-6-terra`	$0.70 / $4.20	các lượt xử lý ngữ cảnh dài trên kho mã lớn

Thanh toán theo token từ số dư trả trước, không có phí hàng tháng — xem trang Thanh toán. Với ngữ cảnh lặp lại — chiếm phần lớn dữ liệu mà trình chỉnh sửa hoặc ứng dụng trò chuyện gửi đi — bộ nhớ đệm prompt ảnh hưởng đến hóa đơn nhiều hơn lựa chọn mô hình.

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

Làm cách nào để trỏ Roo Code đến một endpoint tương thích OpenAI tùy chỉnh?

Trong bảng cài đặt Roo Code, đặt API Provider thành "OpenAI Compatible", sau đó điền Base URL và API Key của endpoint đó rồi chọn một mô hình. URL cơ sở là đường dẫn gốc /v1 của dịch vụ, vì Roo Code chỉ nối thêm tuyến vào đó. Tài liệu riêng của Roo Code gọi trường Base URL là trường cốt yếu — trường này quyết định nơi mọi yêu cầu được gửi đến.

Những mô hình nào hoạt động với Roo Code thông qua endpoint tùy chỉnh?

Bất kỳ mô hình nào được endpoint cung cấp và hỗ trợ gọi công cụ native tương thích với OpenAI. Roo Code chỉ sử dụng lời gọi công cụ native và không có chế độ dự phòng, vì vậy mô hình không hỗ trợ công cụ sẽ kết nối được nhưng sau đó lỗi ngay khi tác tử thử đọc hoặc ghi tệp. Các mô hình văn bản Claude và GPT đều đáp ứng; mô hình hình ảnh, video và âm thanh thì không.

Tôi nên nhập gì vào Context Window và Max Output Tokens của Roo Code?

Hãy nhập giới hạn thực tế của mô hình bạn đã chọn, không dùng giá trị mặc định. Roo Code dùng hai con số này để quyết định thời điểm rút gọn hội thoại, vì vậy giá trị thấp hơn dung lượng ngữ cảnh thực của mô hình sẽ khiến ứng dụng loại bỏ lịch sử không cần thiết, còn giá trị cao hơn sẽ gây lỗi 400 từ máy chủ thượng nguồn thay vì rút gọn hội thoại gọn gàng. Thông số của từng mô hình có trong danh mục mô hình của endpoint.

Vì sao Roo Code báo sai chi phí cho một tác vụ?

Vì Input Price và Output Price trong Model Configuration được nhập thủ công, và mặc định bằng không hoặc theo mức giá của một nhà cung cấp khác. Roo Code tính toàn bộ chi phí hiển thị cho mỗi tác vụ từ hai trường đó — ứng dụng không đọc giá từ endpoint — nên con số chỉ chính xác khi thông tin đã nhập chính xác. Hãy sao chép mức giá từ danh mục riêng của nhà cung cấp.