Kilo Code với Claude API — thiết lập base URL tương thích OpenAI và định tuyến theo từng chế độ

Kilo Code là một trong những agent lập trình AI mã nguồn mở được sử dụng nhiều nhất cho VS Code, và giống các sản phẩm cùng họ Cline, nó cho phép bạn tự mang endpoint API tương thích OpenAI của mình. Điều đó có nghĩa là bạn có thể chạy Claude trong trình chỉnh sửa bằng một khóa sk-kn- duy nhất, với giá khoảng thấp hơn 30% so với giá niêm yết của Anthropic trên các mô hình chính. Hướng dẫn này trình bày thiết lập ba trường, chọn mô hình Claude nào cho từng tác vụ và chi phí thực tế của một phiên lập trình agent.

Vì sao Kilo Code cần khóa API

Kilo Code không tích hợp sẵn mô hình — mọi hành động (đọc tệp, đề xuất chỉnh sửa, chạy lệnh, kiểm tra kết quả) đều là một lệnh gọi API, được tính phí theo token. Một gói đăng ký trò chuyện như Claude Pro không bao gồm việc này; tiện ích mở rộng cần quyền truy cập API trực tiếp. Đó chính là loại dịch vụ Kunavo cung cấp: trả theo mức sử dụng từ khoản nạp $10, một khóa cho Claude và GPT, và số dư không bao giờ hết hạn. Vì các vòng lặp agent gửi lại ngữ cảnh tác vụ ngày càng lớn ở mỗi bước, đơn giá token là đòn bẩy lớn nhất quyết định chi phí phiên — đó là lý do mức giảm giá khoảng ~30% trên claude-sonnet-5 cộng dồn rất nhanh.

Ba trường

Kilo Code cung cấp nhà cung cấp dưới dạng ba trường cài đặt:

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...          # create at kunavo.com/app/keys
Model ID       claude-sonnet-5        # or claude-opus-5 / claude-haiku-4-5

Lấy khóa từ bảng điều khiển sau khi đăng ký và nạp $10 — khóa chỉ được hiển thị một lần, vì vậy hãy lưu ngay. Việc quản lý khóa đầy đủ được trình bày trong tài liệu khóa Claude API.

Thiết lập Kilo Code

1. Cài đặt Kilo Code từ marketplace của VS Code và mở nó từ thanh bên.
2. Mở cài đặt tiện ích mở rộng (biểu tượng bánh răng) và đi đến phần Providers.
3. Đặt API Provider thành OpenAI Compatible.
4. Base URL: https://api.kunavo.com/v1 · API key: khóa sk-kn-… của bạn · Model: claude-sonnet-5.
5. Lưu, sau đó yêu cầu nó làm một việc nhỏ (“giải thích tệp này”) để xác nhận kết nối trước khi cho phép chỉnh sửa mã.

Kilo Code hỗ trợ ghi đè mô hình theo từng chế độ (Architect / Code / Debug) — đây là nơi phù hợp để định tuyến việc lập kế hoạch đến mô hình mạnh hơn (claude-opus-5) và việc thực thi đến mô hình rẻ hơn (claude-sonnet-5).

Cline và Roo Code

Kilo Code và Roo Code đều là các fork trong họ Cline, vì vậy ba trường trên giống hệt nhau trong cả ba công cụ — nhà cung cấp OpenAI Compatible, base URL https://api.kunavo.com/v1, khóa, ID mô hình. Điểm khác là tính năng mỗi công cụ cung cấp để định tuyến mô hình, và đó là nơi tạo ra khoản tiết kiệm, nên mỗi công cụ có hướng dẫn riêng: Cline với Claude API trình bày cách tách Plan/Act, còn Roo Code với Claude API trình bày cấu hình được đặt tên và liên kết mô hình theo chế độ.

Cả ba công cụ còn cung cấp nhà cung cấp Anthropic gốc với tùy chọn base URL tùy chỉnh. Trỏ tùy chọn đó đến https://api.kunavo.com sẽ sử dụng Messages API gốc (/v1/messages) — hữu ích vì cache_control được truyền qua không dịch và đầu vào được lưu trong bộ nhớ đệm được tính bằng 10% giá đầu vào (xem tài liệu bộ nhớ đệm lời nhắc). Cả hai tuyến đều hoạt động; tuyến tương thích OpenAI là cách đơn giản nhất để bắt đầu.

Tuy vậy, bản thân việc lưu lời nhắc vào bộ nhớ đệm không cần đến tuyến Anthropic gốc. Với lời nhắc dài, Kunavo tự đặt các điểm ngắt bộ nhớ đệm trên tuyến tương thích OpenAI: trên lời nhắc hệ thống, trên các định nghĩa công cụ và trên tin nhắn cuối cùng khi cuộc trò chuyện đã có lượt trả lời của trợ lý; trong vòng lặp tác tử, điều kiện này được đáp ứng ở mọi bước sau bước đầu tiên. cache_control mà tiện ích mở rộng đặt trên tuyến đó được giữ nguyên. Trên tuyến gốc, yêu cầu được chuyển tiếp đúng như tiện ích mở rộng đã gửi và không có điểm ngắt nào được thêm vào, vì vậy những gì được lưu vào bộ nhớ đệm phụ thuộc vào các điểm ngắt mà tiện ích mở rộng đặt.

Nên chọn mô hình Claude nào

claude-opus-5 là lựa chọn suy luận mạnh trong trường hợp này: đây là Opus mới nhất của Anthropic và được tính phí ở cùng mức $3,50 / $17,50 như claude-opus-4-7 thế hệ trước ($3,50 / $17,50), vốn vẫn khả dụng nếu bạn đã cố định dùng nó. Vì trường mô hình chỉ là một slug trên cùng endpoint, việc chuyển đổi chỉ là thay đổi một từ — không cần khóa mới, không cần cấu hình nhà cung cấp mới. Mức giá đầy đủ cho mọi mô hình có trong hướng dẫn giá Claude API và trên trang giá.

Chi phí thực tế của một phiên

Các công cụ agent vốn tiêu thụ nhiều token: mỗi bước gửi lại system prompt, lịch sử tác vụ và ngữ cảnh tệp mới. Các con số thực tế theo giá Kunavo:

Phép tính có thể chạy được:

# Kunavo Claude rates (USD per 1M tokens): (input, output)
RATES = {
    "claude-haiku-4-5":  (0.70, 3.50),
    "claude-sonnet-5":   (1.40, 7.00),
}

def step_cost(model, in_tokens, out_tokens):
    i, o = RATES[model]
    return in_tokens / 1_000_000 * i + out_tokens / 1_000_000 * o

# One agentic step: the tool resends the task context + file reads.
print(step_cost("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# A realistic 20-step task (edit, run, fix, repeat):
print(20 * step_cost("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87

Giảm hóa đơn

1. Bắt đầu tác vụ mới thay vì kéo dài một tác vụ mãi. Công cụ gửi lại toàn bộ cuộc trò chuyện ở mỗi bước, vì vậy tác vụ chạy lâu sẽ tốn chi phí theo cấp số bình phương. Tác vụ mới = ngữ cảnh mới, nhỏ.
2. Định tuyến theo chế độ. Kilo Code hỗ trợ một mô hình cho mỗi chế độ — Architect trên claude-opus-5, Code trên claude-sonnet-5, câu hỏi nhanh trên claude-haiku-4-5. Việc lập kế hoạch chỉ chiếm một phần nhỏ token, nên dùng mô hình mạnh hơn ở đó tốn ít.
3. Dùng tuyến Anthropic gốc để lưu bộ nhớ đệm. Đầu vào được lưu trong bộ nhớ đệm tính phí bằng 10% giá đầu vào — trong một vòng lặp gửi lại tiền tố ổn định ở mỗi bước, đây là khoản tiết kiệm lớn nhất hiện có (cách hoạt động).
4. Theo dõi chi tiêu theo khóa. Cấp cho trình chỉnh sửa một khóa riêng với giới hạn chi tiêu trong bảng điều khiển và kiểm tra mức sử dụng để biết chi phí thực sự của một tuần lập trình agent.

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