Aller au contenu
Inscrivez-vous gratuitement
Configuration des Coding Agents

Configurer Roo Code : clé API, Base URL et modèles

Installez Roo Code, configurez la Base URL et l’API Key BetterToken, choisissez un modèle disponible et résolvez les erreurs courantes.

Pour connecter Roo Code à BetterToken, préparez une API Key, saisissez la Base URL ci-dessous et choisissez un Model ID actuel dans le model plaza.

Paramètres principaux

ChampValeur
API KeyBetterToken API Key
Base URLhttps://bettertoken.ai/v1
ModelUn Model ID actuel du model plaza

Prérequis

Inscrivez-vous et obtenez une BetterToken API Key

Vous avez déjà un compte ? Connectez-vous, rechargez votre solde, puis créez une clé dans la console.

Exigences supplémentaires

  • VS Code est installé

Installation

Installer Roo Code

Ouvrez VS Code, recherchez Roo Code dans la marketplace des extensions et installez-le.

Configuration manuelle

Effectuez cette configuration dans l’interface des paramètres Roo Code. Vous n’avez pas besoin de modifier de fichier de configuration.

ChampValeur
API KeyBetterToken API Key
Base URLhttps://bettertoken.ai/v1
ModelUn Model ID actuel du model plaza

Configuration

Effacer les variables d’environnement en conflit

Fenêtre de terminal
unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Ouvrir les paramètres Roo Code

Ouvrez le panneau Settings de Roo Code.

Configurer le fournisseur d’API

Renseignez :

  • API Provider → OpenAI Compatible
  • Base URL → https://bettertoken.ai/v1
  • API Key → votre BetterToken API Key
  • Model → un model ID disponible copié depuis le model plaza

Configurer des en-têtes supplémentaires uniquement si la documentation officielle l’exige explicitement

La documentation officielle Roo Code consultée se concentre sur la configuration d’API OpenAI compatible ou personnalisée, mais ne traite pas un User-Agent supplémentaire comme une étape obligatoire pour BetterToken.

Si vous utilisez aussi une passerelle personnalisée, un routage de locataire, une couche d’observabilité ou de cache, ajoutez des en-têtes uniquement selon la documentation officielle de ce service en amont.

Enregistrer et commencer à l’utiliser

Cliquez sur Save et Done, puis sélectionnez le modèle configuré.

Redémarrer Roo Code

Après avoir enregistré la configuration, redémarrez VS Code ou rechargez l’extension Roo Code avant de sélectionner le modèle configuré.

Vérifier la connexion

Envoyez un court prompt de test. Si l’outil renvoie une réponse sans erreur d’authentification ni erreur de Model ID, la connexion fonctionne. Redémarrez complètement l’outil après avoir modifié sa configuration.

Demandez ensuite à Roo Code de lire un fichier du projet et de le résumer. Vérifiez qu’il exécute l’outil de lecture et utilise son résultat ; une réponse textuelle seule ne valide pas l’utilisation des outils par l’agent.

Changer de modèle

Ouvrez le sélecteur de modèle ou modifiez le champ Model dans la configuration. Utilisez le Model ID exact du model plaza, puis redémarrez la session actuelle.

Erreurs courantes

ErreurVérifications
401 ou UnauthorizedVérifiez la BetterToken API Key et supprimez les espaces initiaux ou finaux.
404Vérifiez la Base URL et n’ajoutez pas de chemin d’endpoint spécifique.
model not foundCopiez un Model ID actuel depuis le model plaza.
Les modifications ne sont pas appliquéesEnregistrez la configuration et redémarrez complètement l’outil.

Détails techniques

Protocole, endpoint et champs internes du fournisseur

Cette configuration utilise https://bettertoken.ai/v1. L’outil ajoute le chemin d’endpoint OpenAI compatible. N’ajoutez pas /chat/completions ni /responses sauf si un champ spécifique l’exige explicitement.