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).
- Console : https://aicentos.com
- Créer une clé : https://aicentos.com/keys
- Recharger le portefeuille : 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.
- macOS / Linux :
- Écrivez le contenu suivant, en remplaçant
idpar 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 (
apiKeyeturlacceptent 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.
urldoit être le chemin complet/v1/chat/completions;https://aicentos.com/v1seul n'aurait aucun effet.- La structure la plus externe doit être
{"models": [...]};modelsest un champ de premier niveau obligatoire. availableModelsest 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.jsonles permissions600et 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. AvecCODEBUDDY_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