# Kilo CLI

Nguồn: https://docs.aicentos.com/vi/clients/kilo-cli

Language: vi

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

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`).

* Console: [https://aicentos.com](https://aicentos.com)
* Tạo Key: [https://aicentos.com/keys](https://aicentos.com/keys)
* Nạp tiền Ví: [https://aicentos.com/wallet](https://aicentos.com/wallet)

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

```bash
npm install -g @kilocode/cli
```

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

| Trường                                 | Giá trị                                               |
| -------------------------------------- | ----------------------------------------------------- |
| Gói provider (`npm`)                   | `@ai-sdk/openai-compatible`                           |
| `options.baseURL`                      | `https://aicentos.com/v1`                             |
| `options.apiKey`                       | Key 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:

```json
{
  "$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:

```bash
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](https://docs.aicentos.com)