# CodeBuddy

Source: https://docs.aicentos.com/fr/clients/codebuddy

Language: fr

> Connecter le point d'accès compatible OpenAI d'aicentos dans CodeBuddy (IDE / CLI) via models.json

CodeBuddy prend en charge les modèles personnalisés : via un `models.json` utilisateur ou de projet, les requêtes peuvent être pointées vers le point d'accès compatible OpenAI d'aicentos. L'IDE et la CLI CodeBuddy Code partagent la même configuration.

## Prérequis

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

* 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)

## Configuration à renseigner

| Champ                                | Valeur                                                              |
| ------------------------------------ | ------------------------------------------------------------------- |
| Base URL                             | `https://aicentos.com/v1`                                           |
| URL du point d'accès (champ `url`)   | `https://aicentos.com/v1/chat/completions`                          |
| API Key (`apiKey`)                   | La clé créée dans la console                                        |
| Identifiant du modèle (`id`)         | nom du modèle dans la « place de marché des modèles » de la console |
| `supportsToolCall`                   | `true`                                                              |
| `maxInputTokens` / `maxOutputTokens` | selon le modèle choisi                                              |

Remarque : le champ `url` de `models.json` exige le **chemin d'interface complet**, qui doit se terminer par `/chat/completions`.

## Étapes de configuration

* Ouvrez CodeBuddy une fois, pour qu'il génère son répertoire de configuration.
* Créez ou éditez le fichier de configuration utilisateur :
  * macOS / Linux : `~/.codebuddy/models.json`
  * Windows : `C:\Users\<nom-d'utilisateur>\.codebuddy\models.json`
  * Pour ne viser qu'un seul projet, utilisez plutôt le fichier de projet `<racine-du-projet>/.codebuddy/models.json`, prioritaire sur celui de l'utilisateur.
* Écrivez le contenu suivant, en remplaçant `id` par le nom d'un modèle dont vous avez vérifié la disponibilité dans la console :

```json
{
  "models": [
    {
      "id": "gpt-5",
      "name": "GPT-5 (aicentos)",
      "vendor": "aicentos",
      "apiKey": "${AICENTOS_API_KEY}",
      "url": "https://aicentos.com/v1/chat/completions",
      "maxInputTokens": 128000,
      "maxOutputTokens": 16384,
      "supportsToolCall": true,
      "supportsImages": false,
      "supportsReasoning": false
    }
  ]
}
```

* Définissez la variable d'environnement (`apiKey` et `url` acceptent tous deux les références `${VAR_NAME}`) :

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

* Quittez complètement CodeBuddy puis rouvrez (le redémarrage du panneau IDE suffit).
* Sélectionnez le modèle que vous venez de configurer dans le sélecteur de modèles.

Si vous préférez ne pas éditer de fichier, cliquez dans le panneau de conversation de l'IDE CodeBuddy sous le sélecteur de modèles → **Configurer un modèle personnalisé** → fournisseur **Custom**, puis renseignez la Base URL `https://aicentos.com/v1`, l'API Key et le nom du modèle.

## Test

Après enregistrement, ouvrez une nouvelle conversation ou tâche de codage et commencez par un prompt simple et léger ; attendez une réponse normale avant un usage sérieux.

## Remarques

* Seules les API au **format d'interface OpenAI** sont prises en charge pour l'instant.
* `url` doit être le chemin complet `/v1/chat/completions` ; `https://aicentos.com/v1` seul n'aurait aucun effet.
* La structure la plus externe doit être `{"models": [...]}` ; `models` est un champ de premier niveau obligatoire.
* `availableModels` est une liste blanche : dès qu'elle est remplie, le menu déroulant des modèles ne montre que les modèles listés et les modèles intégrés disparaissent aussi. Omettez ce champ si vous ne souhaitez pas de restriction.
* Enregistrez le fichier en **UTF-8 sans BOM** ; un JSON avec BOM empêche la lecture de la configuration des modèles locaux.
* Les variables d'environnement sont résolues au démarrage ; si la variable n'existe pas, `${AICENTOS_API_KEY}` reste littéralement tel quel et provoque l'échec des appels.
* Il est conseillé de donner au `models.json` les permissions `600` et de ne pas le commiter dans un dépôt.
* La CLI peut aussi se configurer par variables d'environnement : `CODEBUDDY_API_KEY`, `CODEBUDDY_BASE_URL`, `CODEBUDDY_MODEL`. Avec `CODEBUDDY_BASE_URL`, ne mettez pas `/chat/completions` : la CLI l'ajoute elle-même.
* Pour plus de détails, voir le site de documentation : [https://docs.aicentos.com](https://docs.aicentos.com)