Kilo Code là gì?
Kilo Code, từ Kilo AI, là một tác nhân mã hóa AI nguồn mở có sẵn trong VS Code, JetBrains và CLI, với các nhà cung cấp mô hình có thể định cấu hình.
Hướng dẫn thiết lập Kilo Code này sử dụng các điều khiển của nhà cung cấp OpenAI-compatible để kết nối TokenHub. Bắt đầu với tác vụ chỉ đọc, sau đó xác thực các chỉnh sửa và lệnh bằng mô hình có khả năng sử dụng công cụ. Kilo Code hiển thị các quy trình công việc liên quan trong VS Code, JetBrains và CLI, nhưng phạm vi cấu hình có thể khác nhau giữa các máy khách đó. Xác nhận hồ sơ và nhà cung cấp đang hoạt động trong ứng dụng khách mà bạn thực sự đang sử dụng, sau đó xác nhận chất lượng mô hình compare, độ tin cậy của công cụ, độ trễ, độ dài ngữ cảnh và chi phí cho tác vụ kho lưu trữ đại diện.
Kilo Code có thể định tuyến yêu cầu mô hình qua cổng API OpenAI compatible tương thích của TokenHub. Giữ nguyên cách cài đặt chính thức, sau đó thay API key, Base URL và model ID.
Endpoint TokenHub dùng trong hướng dẫn này là https://us-api.tokenhub.com/v1/chat/completions.
Khi nào nên dùng
Bắt đầu với repository nhỏ hoặc dự án thử nghiệm. Trước tiên yêu cầu công cụ đọc file, giải thích mã hoặc lập kế hoạch, rồi mới bật chỉnh sửa.
Cài đặt hoặc mở công cụ
Làm theo tài liệu chính thức của Kilo Code để cài đặt hoặc mở công cụ. Nếu giao diện thay đổi, ưu tiên tài liệu hiện tại.
Với công cụ CLI, hãy kiểm tra executable trước khi thêm thông tin xác thực TokenHub:
# open the tool, then open its model or provider settingsChuẩn bị thông tin xác thực TokenHub
Tạo TokenHub API key và chọn một mô hình phù hợp từ danh sách mô hình TokenHub.
export TOKENHUB_API_KEY="sk-..."Lưu key trong shell cục bộ, kho bí mật của IDE hoặc trường API key an toàn của công cụ. Không commit key vào repository.
Cấu hình nhà cung cấp TokenHub
Trong phần Models, Providers, API Keys hoặc OpenAI Compatible, nhập các giá trị dưới đây.
Giá trị provider
| Trường | Giá trị |
|---|---|
| Nhà cung cấp | OpenAI Compatible hoặc Custom |
| Base URL | https://us-api.tokenhub.com/v1 |
| API Key | Giá trị của TOKENHUB_API_KEY |
| Mô hình | gpt-4.1 hoặc model ID TokenHub khác |
Vị trí file cài đặt
| Trường | Giá trị |
|---|---|
| Provider settings | Kilo Code → Providers → Custom provider |
| Provider API | OpenAI Compatible |
| Required fields | Provider ID, Base URL, API Key, Model ID |
Save the custom provider in Kilo Code, let it fetch /v1/models when available, or add the TokenHub model ID manually. Verify a chat request before enabling agent edits.
Nếu công cụ tách chat, edit, apply và fast models, hãy dùng cùng một mô hình TokenHub cho lần thử đầu tiên. Sau đó mới tách theo chi phí, độ trễ và năng lực suy luận.
Biến môi trường tạm thời chỉ để debug
Khi extension sở hữu schema riêng, hãy dùng UI cài đặt trước. UI sẽ lưu cùng giá trị vào user settings và tránh phải đoán private key có thể đổi theo phiên bản.
Chỉ dùng biến tạm thời để kiểm tra key, mạng và tên mô hình. Sau khi xác minh, chuyển cùng giá trị vào cấu hình bền vững ở trên.
Xác minh kết nối
Trước tiên dùng prompt chỉ đọc để xác nhận mô hình đọc được ngữ cảnh và không sửa file. Sau đó mới thử chỉnh sửa hoặc tác vụ agent.
Đọc README của dự án và tóm tắt trong ba câu. Không chỉnh sửa file.Sau khi prompt chạy thành công, kiểm tra log TokenHub để xác nhận tên mô hình, endpoint, lượng token và billing group.
Khắc phục sự cố
| Hiện tượng | Cách xử lý |
|---|---|
| 401 hoặc lỗi xác thực | Kiểm tra TOKENHUB_API_KEY còn hợp lệ và đã lưu trong cùng terminal, IDE hoặc profile client. |
| 404 hoặc không tìm thấy mô hình | Dùng model ID có trong workspace TokenHub và phù hợp với giao thức đã chọn. |
| Sai endpoint | Giữ Base URL đúng như phần trên. Công cụ tương thích OpenAI thường cần /v1; công cụ tương thích Claude thường không cần. |
| Request timeout | Kiểm tra đường mạng tới https://us-api.tokenhub.com, proxy settings và allowlist của workspace. |
| Công cụ dùng mô hình khác | Kiểm tra lại mọi trường chat, edit, apply, fast hoặc autocomplete. |
Chọn mô hình
Kilo Code tùy chỉnh API FAQ
Tại sao Kilo Code không thể đọc danh sách mẫu TokenHub?
Việc phát hiện mô hình tự động không thành công không nhất thiết có nghĩa là API không khả dụng. Sao chép ID mẫu chính xác từ TokenHub và nhập thủ công.
Điều gì sẽ xảy ra nếu Chat hoạt động nhưng Tab completion thì không?
Trò chuyện và Tab có thể sử dụng các khe mô hình khác nhau. Định cấu hình mô hình có độ trễ thấp, completion-compatible cho Tab và xác minh mô hình đó một cách riêng biệt.
Tại sao IDE không đọc được TOKENHUB_API_KEY?
IDE được khởi chạy từ biểu tượng trên màn hình có thể không kế thừa các biến môi trường đầu cuối. Sử dụng trường khóa API an toàn của Kilo Code để complete xác minh ban đầu.
Các tiện ích mở rộng Kilo Code CLI và IDE có chia sẻ một cấu hình mô hình không?
Họ có thể sử dụng cùng một mẫu TokenHub nhưng phạm vi cấu hình và cấu hình có thể khác nhau. Xác minh Base URL, khóa, kiểu máy và hồ sơ hoạt động trong mỗi máy khách.
Điều gì sẽ xảy ra nếu Kilo Code có thể trò chuyện nhưng không thể chỉnh sửa mã?
Xác nhận rằng mô hình hỗ trợ lệnh gọi công cụ gốc và đối số có cấu trúc, sau đó kiểm tra quyền chỉnh sửa và phê duyệt lệnh. Việc tạo văn bản cơ bản không xác nhận chuỗi công cụ tác nhân.
Tài liệu tham khảo
Cấu hình này dựa trên TokenHub và tài liệu chính thức; lần xác minh gần nhất: 2026-09-04。
