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
| Champ | Valeur |
|---|---|
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai/v1 |
| Model | Un Model ID actuel du model plaza |
Prérequis
- La version actuelle de l’outil est installée
- Une BetterToken API Key : inscrivez-vous pour en obtenir une
- Un Model ID du model plaza
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.
| Champ | Valeur |
|---|---|
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai/v1 |
| Model | Un Model ID actuel du model plaza |
Configuration
Effacer les variables d’environnement en conflit
unset OPENAI_API_KEYunset OPENAI_BASE_URLOuvrir 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
| Erreur | Vérifications |
|---|---|
401 ou Unauthorized | Vérifiez la BetterToken API Key et supprimez les espaces initiaux ou finaux. |
404 | Vérifiez la Base URL et n’ajoutez pas de chemin d’endpoint spécifique. |
model not found | Copiez un Model ID actuel depuis le model plaza. |
| Les modifications ne sont pas appliquées | Enregistrez 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.

