Skip to Content
aicentos

Kilo CLI

Kết nối aicentos trong công cụ dòng lệnh Kilo qua file cấu hình

Cập nhật lần cuối:

Kilo CLI khai báo Provider và mô hình qua một file cấu hình JSON / JSONC, hỗ trợ dùng @ai-sdk/openai-compatible trỏ về endpoint OpenAI tương thích bất kỳ, nên có thể kết nối thẳng aicentos.

Chuẩn bị

Trước tiên, tạo một Key chuyên dụng cho công cụ dòng lệnh tại trang "API Key" trong Console (khuyến nghị đặt tên kilo-cli).

Đồng thời xác nhận đã cài toàn cục Kilo CLI:

npm install -g @kilocode/cli

Cấu hình cần điền

TrườngGiá trị
Gói provider (npm)@ai-sdk/openai-compatible
options.baseURLhttps://aicentos.com/v1
options.apiKeyKey tạo trong Console (có thể tham chiếu {env:VAR})
Tham chiếu mô hình (model lớp ngoài)dạng provider/model, ví dụ aicentos/gpt-5
limit.context / limit.outputđiền theo mô hình đã chọn

Các bước thiết lập

  • Tạo mới hoặc sửa file cấu hình toàn cục:
    • ~/.config/kilo/kilo.json (hoặc kilo.jsonc); khi đã thiết lập XDG_CONFIG_HOME thì lấy thư mục đó làm chuẩn.
    • ./kilo.jsonc cấp dự án sẽ ghi đè các mục cùng tên trong cấu hình toàn cục.
  • Ghi nội dung sau:
{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "aicentos/gpt-5",
  "provider": {
    "aicentos": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "aicentos",
      "options": {
        "baseURL": "https://aicentos.com/v1",
        "apiKey": "{env:AICENTOS_API_KEY}"
      },
      "models": {
        "gpt-5": {
          "name": "GPT-5",
          "limit": { "context": 128000, "output": 16384 }
        }
      }
    }
  }
}
  • Xuất biến môi trường:
export AICENTOS_API_KEY="sk-Key-aicentos-của-bạn"
  • Chạy kilo trong thư mục dự án, hoặc trong giao diện tương tác dùng /model để chuyển mô hình.

Kiểm tra

Sau khi khởi động, trước tiên test nhẹ bằng một câu prompt đơn giản, xác nhận có thể trả về kết quả bình thường rồi mới chính thức sử dụng.

Lưu ý

  • options.baseURL chỉ điền đến https://aicentos.com/v1, đừng bổ sung thành /v1/chat/completions đầy đủ.
  • Cú pháp thay thế biến môi trường {env:VAR} chỉ có hiệu lực trong file cấu hình toàn cục; kilo.jsonc cấp dự án vì lý do an toàn sẽ không phân giải {env:...}.
  • Mô hình tùy chỉnh phải khai báo rõ limit.context và limit.output, nếu không độ dài ngữ cảnh sẽ được xử lý là 0, tính năng tự nén sẽ mất tác dụng.
  • Nếu gateway không cung cấp giao diện danh sách /v1/models, tự động dò tìm mô hình sẽ thất bại, khai báo thủ công theo cách viết ở trên là được.
  • Xem thêm giải thích tại trang tài liệu: https://docs.aicentos.com