Qu’est-ce que le Roo Code ?
Roo Code est un agent de codage VS Code open source qui peut utiliser des fournisseurs compatibles OpenAI, modifier des fichiers et exécuter des outils approuvés.
Ce guide Roo Code ajoute TokenHub via ses paramètres de fournisseur compatible OpenAI. Testez d'abord une tâche en lecture seule, puis validez l'appel de l'outil natif avant d'activer les modifications de fichiers ou les commandes de terminal. Roo Code peut lire des fichiers, proposer des modifications et exécuter des outils de terminal à partir de VS Code, la connectivité du fournisseur et la capacité de l'agent doivent donc être testées séparément. Désactivez l'approbation automatique lors de la première exécution, utilisez un référentiel jetable et examinez chaque action demandée jusqu'à ce que le modèle sélectionné s'avère fiable avec les appels d'outils natifs.
Roo Code peut acheminer ses requêtes de modèle via la passerelle API OpenAI compatible de TokenHub. Gardez l’installation officielle, puis remplacez seulement la clé API, la Base URL et l’ID du modèle.
L’endpoint TokenHub utilisé dans ce guide est https://us-api.tokenhub.com/v1/chat/completions.
Quand l’utiliser
Commencez dans un petit dépôt ou un projet de test. Demandez d’abord à l’outil de lire des fichiers, expliquer le code ou proposer un plan, puis activez les modifications.
Installer ou ouvrir l’outil
Suivez la documentation officielle Roo Code pour installer ou ouvrir l’outil. Si les menus changent, suivez la version actuelle de la documentation.
Pour les outils CLI, vérifiez que l’exécutable fonctionne avant d’ajouter les identifiants TokenHub :
# open the tool, then open its model or provider settingsPréparer les identifiants TokenHub
Créez une clé API TokenHub et choisissez dans la liste des modèles TokenHub un modèle adapté à cet outil.
export TOKENHUB_API_KEY="sk-..."Conservez la clé dans votre shell local, le stockage secret de l’IDE ou le champ API key sécurisé de l’outil. Ne la commitez pas dans le dépôt.
Configurer le fournisseur TokenHub
Dans les réglages Models, Providers, API Keys ou OpenAI Compatible, renseignez les valeurs ci-dessous.
Valeurs du provider
| Champ | Valeur |
|---|---|
| Fournisseur | OpenAI Compatible ou Custom |
| Base URL | https://us-api.tokenhub.com/v1 |
| API Key | La valeur de TOKENHUB_API_KEY |
| Modèle | gpt-4.1 ou un autre model ID TokenHub |
Emplacements des réglages
| Champ | Valeur |
|---|---|
| Provider settings | Roo Code provider settings or configuration profile |
| Provider mode | OpenAI Compatible |
| Required fields | Base URL, API Key, Model ID |
Utilisez d’abord l’interface de réglages quand l’extension possède son propre schéma. Elle stocke les mêmes valeurs au niveau utilisateur et évite de deviner des clés privées qui peuvent changer.
Use a model that supports OpenAI tool calling for Code mode tasks.
Si l’outil sépare chat, edit, apply et fast models, utilisez le même modèle TokenHub pour le premier test. Séparez-les ensuite selon le coût, la latence et la capacité de raisonnement.
Variables temporaires pour le diagnostic
Utilisez d’abord l’interface de réglages quand l’extension possède son propre schéma. Elle stocke les mêmes valeurs au niveau utilisateur et évite de deviner des clés privées qui peuvent changer.
Utilisez les variables temporaires seulement pour vérifier la clé, le réseau et le nom du modèle. Après validation, déplacez les mêmes valeurs dans la configuration persistante ci-dessus.
Vérifier la connexion
Testez d’abord avec une consigne en lecture seule pour confirmer que le modèle lit le contexte sans modifier les fichiers. Testez ensuite les actions d’édition ou d’agent.
Lis le README du projet et résume-le en trois phrases. Ne modifie aucun fichier.Après un prompt réussi, consultez les logs TokenHub pour vérifier le modèle, l’endpoint, les tokens consommés et le groupe de facturation.
Dépannage
| Symptôme | Correction |
|---|---|
| 401 ou échec d’authentification | Vérifiez que TOKENHUB_API_KEY est valide et enregistré dans le même terminal, IDE ou profil client. |
| 404 ou modèle introuvable | Utilisez un model ID présent dans votre espace TokenHub et compatible avec le protocole choisi. |
| Endpoint incorrect | Gardez exactement la Base URL indiquée ci-dessus. Les outils compatibles OpenAI demandent généralement /v1; les outils compatibles Claude non. |
| Timeout | Vérifiez le réseau vers https://us-api.tokenhub.com, les paramètres proxy et l’allowlist de l’espace de travail. |
| L’outil utilise un autre modèle | Revérifiez tous les emplacements chat, edit, apply, fast ou autocomplete. |
Choisir un modèle
FAQ du fournisseur d'API Roo Code
Quel fournisseur d'API dois-je choisir dans Roo Code ?
Choisissez OpenAI Compatible, puis entrez l'URL de base de TokenHub, la clé API et l'ID de modèle exact.
Que se passe-t-il si le chat fonctionne mais que les appels d'outils échouent ?
Basculez d’abord vers un modèle de codage ou d’agent qui prend explicitement en charge les appels d’outils natifs, puis vérifiez les autorisations et le mode d’approbation de Roo Code.
Comment puis-je réduire les risques lors du premier test Roo Code ?
Utilisez un référentiel de test, commencez par une explication en lecture seule, désactivez l'approbation automatique, puis vérifiez progressivement les modifications et les commandes du terminal.
Comment dépanner un Roo Code 401 ?
Vérifiez la clé API pour les caractères ou espaces manquants et confirmez qu'elle est enregistrée dans le profil actif. Réessayez une courte requête et inspectez les journaux TokenHub.
Comment dépanner un Roo Code 404 ?
Utilisez la racine de l'API TokenHub se terminant par /v1, évitez un chemin /chat/completions dupliqué et confirmez que l'ID de modèle existe.
Références
Cette configuration s’appuie sur TokenHub et la documentation officielle ; dernière vérification : 2026-09-04。
