Skip to Content
aicentos

CodeBuddy

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

Dernière mise à jour:

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

Configuration à renseigner

ChampValeur
Base URLhttps://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
supportsToolCalltrue
maxInputTokens / maxOutputTokensselon 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 :
{
  "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}) :
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