Tài liệu

Kilo Code

Nhà cung cấp tùy chỉnh của Kilo Code có bốn trường. Điền các trường đó là tiện ích mở rộng có thể kết nối với Claude và GPT bằng một khóa duy nhất — ứng dụng không bao giờ biết nhà cung cấp nào đứng sau endpoint.

Providers → Custom provider → OpenAI Compatible, base URL có /v1 và nhập model id Claude — Kilo Code không bao giờ biết nhà cung cấp thực sự phía sau.

Cài đặt → Nhà cung cấp → Nhà cung cấp tùy chỉnh

Provider ID    kunavo
Display name   Kunavo
Provider API   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API key        sk-kn-...
Models         claude-sonnet-5
               claude-opus-5
               claude-haiku-4-5

URL cơ sở giữ hậu tố /v1 ở đây — Kilo Code chỉ thêm đường dẫn, và ví dụ được tài liệu hóa của chính ứng dụng cũng kết thúc bằng /v1. Điều này ngược với các ứng dụng khách kiểu Anthropic, vốn cần origin thuần.

Provider API là bộ chọn giao thức, không phải nhà cung cấp. Chọn OpenAI Compatible rồi nhập mã model Claude là cách kết hợp được chủ đích: mã này được phân giải tại endpoint, không phải trong tiện ích mở rộ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 Kilo 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ở phần cài đặt Kilo Code (biểu tượng bánh răng), vào thẻ Providers, cuộn xuống cuối rồi nhấp Custom provider.
Điền Provider ID, Display name, Provider API = OpenAI Compatible, Base URL và API key như trên.
Trong mục Models, bạn có thể tự thêm mã hoặc lấy từ danh sách tự động tải về — Kunavo phản hồi GET /v1/models, nên danh sách sẽ tự động được điền.
Chọn nhà cung cấp trong bộ chọn chế độ trò chuyện rồi gửi tin nhắn. Gán một model giá rẻ cho các chế độ chạy liên tục và một model đắt hơn cho các chế độ lập kế hoạch.

Đã kiểm tra đối chiếu với Trang nhà cung cấp OpenAI Compatible của Kilo 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 Kilo 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 Kilo 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 Kilo Code
`claude-sonnet-5`	$1.40 / $7.00	Các chế độ Code và Architect — model làm việc mặc định
`claude-opus-5`	$3.50 / $17.50	Chế độ Architect cho các lần tái cấu trúc lớn, khi một kế hoạch sai sẽ tốn kém
`claude-haiku-4-5`	$0.70 / $3.50	Chế độ Ask và phân loại tệp nhanh, khi số lượng là yếu tố chi phối
`gpt-5-6-sol`	$2.00 / $12.00	ý kiến thứ hai từ một dòng model khác, dùng cùng khóa

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 để thêm nhà cung cấp tùy chỉnh vào Kilo Code?

Mở phần cài đặt Kilo Code bằng biểu tượng bánh răng, vào thẻ Providers, cuộn xuống cuối danh sách rồi nhấp "Custom provider". Điền Provider ID và Display name, đặt Provider API thành "OpenAI Compatible", dán URL cơ sở và API key của endpoint, sau đó thêm mã model thủ công hoặc từ danh sách tự động tải về. Nhà cung cấp sẽ xuất hiện trong bộ chọn chế độ như các nhà cung cấp tích hợp sẵn.

Kilo Code có thể dùng model Claude mà không cần tài khoản Anthropic không?

Có. Provider API "OpenAI Compatible" của Kilo Code chỉ tên giao thức truyền trên dây, không phải nhà cung cấp, và chuyển nguyên mã model đến URL cơ sở bạn đã cấu hình. Vì vậy, mã Claude được phân giải tại endpoint đó thay vì trong tiện ích mở rộng; thông tin xác thực bạn dùng là của endpoint, không phải của Anthropic.

URL cơ sở Kilo Code có cần kết thúc bằng /v1 không?

Có, với endpoint tương thích OpenAI. Kilo Code chỉ thêm đường dẫn — /chat/completions, /models — nên URL cơ sở phải là gốc /v1, chẳng hạn https://api.kunavo.com/v1. Ví dụ được tài liệu hóa của chính ứng dụng cũng có hậu tố này. Nếu thiếu /v1, bạn sẽ gặp lỗi 404 thay vì lỗi xác thực.

Tại sao Kilo Code không hiển thị model nào sau khi tôi thêm nhà cung cấp?

Danh sách model được tải từ đường dẫn /v1/models của endpoint bằng khóa bạn đã nhập, nên danh sách trống thường có nghĩa là khóa hoặc URL cơ sở không đúng, chứ không phải nhà cung cấp không có model. Kiểm tra cùng cặp thông tin bằng lệnh curl thông thường đến /v1/models: nếu nhận được JSON thì vấn đề nằm trong cấu hình tiện ích mở rộng; lỗi 401 là do khóa; lỗi 404 là do URL. Bạn cũng luôn có thể tự nhập model.