# Kilo CLI

Источник: https://docs.aicentos.com/ru/clients/kilo-cli

Language: ru

> Подключение aicentos в консольной утилите Kilo через файл конфигурации

Kilo CLI объявляет провайдеров и модели в одном файле конфигурации JSON / JSONC и позволяет через `@ai-sdk/openai-compatible` указать на любой OpenAI-совместимый эндпоинт, поэтому aicentos подключается напрямую.

## Подготовка

Сначала создайте на странице «API Key» в консоли отдельный ключ для консольной утилиты (рекомендуемое имя `kilo-cli`).

* Консоль: [https://aicentos.com](https://aicentos.com)
* Создание ключа: [https://aicentos.com/keys](https://aicentos.com/keys)
* Пополнение кошелька: [https://aicentos.com/wallet](https://aicentos.com/wallet)

Также убедитесь, что Kilo CLI установлен глобально:

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

## Конфигурация для заполнения

| Поле                                       | Значение                                                      |
| ------------------------------------------ | ------------------------------------------------------------- |
| Пакет провайдера (`npm`)                   | `@ai-sdk/openai-compatible`                                   |
| `options.baseURL`                          | `https://aicentos.com/v1`                                     |
| `options.apiKey`                           | ключ, созданный в консоли (можно сослаться через `{env:VAR}`) |
| Ссылка на модель (верхнеуровневый `model`) | в формате `provider/model`, например `aicentos/gpt-5`         |
| `limit.context` / `limit.output`           | заполните по выбранной модели                                 |

## Шаги настройки

* Создайте или отредактируйте глобальный файл конфигурации:
  * `~/.config/kilo/kilo.json` (или `kilo.jsonc`); если задана переменная `XDG_CONFIG_HOME`, ориентируйтесь на этот каталог.
  * Файл уровня проекта `./kilo.jsonc` переопределяет одноимённые параметры глобальной конфигурации.
* Запишите следующее содержимое:

```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 }
        }
      }
    }
  }
}
```

* Экспортируйте переменную окружения:

```bash
export AICENTOS_API_KEY="sk-ваш-aicentos-ключ"
```

* Запустите `kilo` в каталоге проекта или переключайте модель через `/model` в интерактивном интерфейсе.

## Проверка

После запуска сначала выполните лёгкий тест простым коротким промптом и убедитесь, что результаты возвращаются корректно, и только потом переходите к полноценной работе.

## Примечания

* В `options.baseURL` указывайте только `https://aicentos.com/v1`, не дописывайте полный путь `/v1/chat/completions`.
* Синтаксис подстановки переменных окружения `{env:VAR}` **работает только в глобальном файле конфигурации**; в файле уровня проекта `kilo.jsonc` из соображений безопасности `{env:...}` не разбирается.
* Для кастомных моделей обязательно явно объявите `limit.context` и `limit.output`, иначе длина контекста считается равной 0 и автосжатие перестанет работать.
* Если шлюз не предоставляет эндпоинт списка `/v1/models`, автоматическое обнаружение моделей завершится ошибкой — просто объявите модели вручную, как показано выше.
* Подробнее — на сайте документации: [https://docs.aicentos.com](https://docs.aicentos.com)