# Codebuff

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

Language: fr

> Connecter aicentos à l'agent en ligne de commande Codebuff via son point de terminaison compatible OpenAI

Codebuff est un agent de codage IA qui s'exécute dans le terminal et orchestre plusieurs sous-agents selon la tâche pour lire le code, élaborer un plan et modifier des fichiers. Par défaut, il se connecte au service hébergé officiel ; si votre version permet de remplacer le point de terminaison compatible OpenAI, vous pouvez diriger les requêtes vers aicentos via des variables d'environnement.

## Vérifier d'abord que votre version prend en charge les points de terminaison personnalisés

Codebuff privilégie officiellement le mode hébergé : connexion avec les quotas officiels, ou utilisation de l'API officielle via `CODEBUFF_API_KEY`. La Base URL personnalisée n'est pas disponible dans toutes les versions ; vérifiez d'abord :

* Exécutez `codebuff --help` et regardez s'il existe des options du type `--base-url` ou `--provider`.
* Vérifiez si votre version lit `OPENAI_BASE_URL` (ou `CODEBUFF_BASE_URL` selon les versions) pour remplacer le point de terminaison.
* Si ni l'un ni l'autre n'est pris en charge, votre version ne passe que par le service officiel et ne peut pas se connecter directement à aicentos.

## Prérequis

Si vous avez confirmé que votre version prend en charge les points de terminaison personnalisés, créez d'abord, sur la page « API Key » de la console, une clé dédiée pour Codebuff (nommez-la par exemple `codebuff-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 aussi que Node.js est installé sur votre machine, ainsi que Codebuff installé globalement :

```bash
npm install -g codebuff
```

## Configuration à renseigner

| Champ    | Valeur                                                              |
| -------- | ------------------------------------------------------------------- |
| Base URL | `https://aicentos.com/v1`                                           |
| API Key  | clé créée dans la console                                           |
| Modèle   | nom du modèle dans la « place de marché des modèles » de la console |

## Étapes de configuration

* Écrivez le point de terminaison et la clé dans la configuration du shell (`~/.zshrc` ou `~/.bashrc`) :

```bash
export OPENAI_API_KEY="sk-votre-clé-aicentos"
export OPENAI_BASE_URL="https://aicentos.com/v1"
```

* Rechargez la configuration : `source ~/.zshrc`.
* Placez-vous dans le répertoire du projet et lancez directement `codebuff`.
* Si votre version prend en charge le paramètre `--model`, vous pouvez préciser le modèle explicitement au lancement ; sinon, changez de modèle avec la commande de sélection dans l'interface interactive.

Certaines versions écrivent la configuration dans un fichier JSON du répertoire de configuration utilisateur (les fichiers d'identifiants ont par défaut les droits `600`, ne les commitez pas dans un dépôt). Si votre version utilise un fichier de configuration plutôt que des variables d'environnement, renseignez-y la même Base URL et la même clé, avec les noms de champs indiqués par `codebuff --help` ou la documentation officielle.

## Test

Après le démarrage, faites d'abord un test léger avec une invite simple, par exemple lui demander de lire un fichier et d'en résumer le contenu ; une fois les résultats confirmés, utilisez-le normalement.

## Remarques

* Les points de terminaison personnalisés relèvent d'un usage avancé ; les noms de champs peuvent varier selon les versions, référez-vous à la sortie de `codebuff --help` sur votre machine.
* `OPENAI_BASE_URL` s'arrête à `https://aicentos.com/v1`, ne le complétez pas en chemin complet `/v1/chat/completions`.
* Codebuff envoie des extraits de code et des sorties de terminal comme contexte ; vérifiez au préalable que cela est conforme aux exigences de conformité des données de votre équipe.
* En cas d'erreur, vérifiez successivement : les variables d'environnement sont actives dans le terminal courant, le nom du modèle correspond à la console, le solde du compte est suffisant ([https://aicentos.com/wallet](https://aicentos.com/wallet)).
* Pour plus de précisions, consultez le site de documentation : [https://docs.aicentos.com](https://docs.aicentos.com)