# Kilo CLI

Source: https://docs.aicentos.com/fr/clients/kilo-cli

Language: fr

> Connecter aicentos à l'outil en ligne de commande Kilo via un fichier de configuration

Kilo CLI déclare les providers et les modèles dans un fichier de configuration JSON / JSONC ; il accepte `@ai-sdk/openai-compatible` pour pointer vers n'importe quel point d'accès compatible OpenAI, ce qui permet de se connecter directement à aicentos.

## Prérequis

Créez d'abord dans la console, page « Clés API », une clé dédiée pour la CLI (nommez-la par exemple `kilo-cli`).

* Console : [https://aicentos.com](https://aicentos.com)
* Créer une clé : [https://aicentos.com/keys](https://aicentos.com/keys)
* Recharger le portefeuille : [https://aicentos.com/wallet](https://aicentos.com/wallet)

Vérifiez également que Kilo CLI est installé globalement :

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

## Configuration à renseigner

| Champ                                | Valeur                                                   |
| ------------------------------------ | -------------------------------------------------------- |
| Paquet du provider (`npm`)           | `@ai-sdk/openai-compatible`                              |
| `options.baseURL`                    | `https://aicentos.com/v1`                                |
| `options.apiKey`                     | clé créée dans la console (référençable via `{env:VAR}`) |
| Référence du modèle (`model` racine) | sous la forme `provider/model`, par ex. `aicentos/gpt-5` |
| `limit.context` / `limit.output`     | selon le modèle choisi                                   |

## Étapes de configuration

* Créez ou éditez le fichier de configuration global :
  * `~/.config/kilo/kilo.json` (ou `kilo.jsonc`) ; si `XDG_CONFIG_HOME` est défini, c'est ce répertoire qui fait foi.
  * Un `./kilo.jsonc` au niveau du projet remplace les entrées homonymes de la configuration globale.
* Écrivez le contenu suivant :

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

* Exportez la variable d'environnement :

```bash
export AICENTOS_API_KEY="sk-votre-clé-aicentos"
```

* Lancez `kilo` dans le répertoire du projet, ou changez de modèle avec `/model` dans l'interface interactive.

## Test

Après le démarrage, faites d'abord un test léger avec une invite simple, et ne passez à l'usage réel qu'une fois les retours confirmés.

## Remarques

* `options.baseURL` s'arrête à `https://aicentos.com/v1`, ne le complétez pas en chemin complet `/v1/chat/completions`.
* La syntaxe de substitution `{env:VAR}` **ne fonctionne que dans le fichier de configuration global** ; par sécurité, un `kilo.jsonc` de projet n'interprète pas `{env:...}`.
* Les modèles personnalisés doivent déclarer explicitement `limit.context` et `limit.output`, sinon la longueur de contexte est traitée comme 0 et la compression automatique cesse de fonctionner.
* Si la passerelle n'expose pas l'interface de liste `/v1/models`, la détection automatique des modèles échoue ; déclarez-les à la main comme indiqué ci-dessus.
* Pour plus de détails, consultez le site de documentation : [https://docs.aicentos.com](https://docs.aicentos.com)