Skip to main content
Roo Code communique avec les modèles via des profils de fournisseur que vous configurez dans son panneau de paramètres. Ajoutez un fournisseur OpenAI Compatible, définissez le Base URL sur https://api.tokios.com/v1, la API Key sur votre clé sk-tok-…, et le Model ID sur le nom de déploiement que vous avez enregistré dans la console Tokios. Roo Code envoie ensuite les requêtes à votre modèle local via le connecteur, où que se trouve cette machine.

​
Prérequis

  • Un connecteur Tokios en cours d’exécution et appairé avec votre modèle local — consultez Installation du connecteur
  • Un nom de déploiement de modèle enregistré — consultez Enregistrer un modèle
  • Une clé API Tokios (sk-tok-…) — consultez Clés API
  • L’extension Roo Code installée dans VS Code

​
Configurez le fournisseur compatible OpenAI

1

Ouvrez les paramètres du fournisseur de Roo Code

Ouvrez le panneau Roo Code dans VS Code et accédez à ses paramètres. Choisissez OpenAI Compatible comme fournisseur d’API.
2

Définir l'URL de base

Définir Base URL sur :
3

Ajouter votre clé API

Collez votre clé sk-tok-… dans le champ API Key. Roo Code l’envoie en tant que jeton Bearer à chaque requête.
4

Définir l'ID du modèle

Définir Model ID sur le nom de déploiement public que vous avez enregistré dans l’onglet Models — par exemple, gemma-tunnel. Il ne s’agit pas de l’ID de modèle local utilisé par votre backend (Ollama, llama.cpp, vLLM ou LM Studio).
Remplacez gemma-tunnel par votre propre nom de déploiement et sk-tok-YOUR_KEY par votre propre clé. Ne jamais les valider dans un fichier de paramètres partagé.

​
Choisir un modèle qui prend en charge l’appel d’outils

Roo Code s’appuie sur l’appel d’outils natif pour lire les fichiers, exécuter des commandes et appliquer des modifications dans votre projet. Si le modèle sous-jacent ne prend pas en charge les appels d’outils natifs, Roo Code ne peut pas analyser ses réponses en actions d’outils — il réessaie et boucle au lieu de progresser. Tokios transmet la structure d’appel d’outils dans une requête directement à votre backend ; que l’appel d’outils fonctionne réellement dépend entièrement du modèle que vous exécutez, et non de Tokios ou du connecteur. Avant de vous fier à Roo Code pour un travail réel, confirmez que votre déploiement est soutenu par un modèle avec une prise en charge native de l’appel d’outils. Voir Choisir un modèle local pour savoir comment comparer les modèles pour les charges de travail d’agent.
Un modèle sans appel d’outils natif ne fonctionnera pas avec Roo Code, même s’il peut fonctionner correctement pour le chat simple via le même déploiement. Si Roo Code semble bloqué à réessayer la même étape, c’est la première chose à vérifier.

​
Dépannage

La clé API envoyée par Roo Code est manquante, mal formée ou a été révoquée. Confirmez que vous avez collé la clé sk-tok-… complète sans espaces superflus, et vérifiez son statut sur l’onglet Keys.
La clé est valide mais n’est pas limitée au déploiement dans Model ID, ou le compte est suspendu. Vérifiez les modèles autorisés pour la clé sur l’onglet Keys.
La valeur Model ID ne correspond pas à un déploiement enregistré. Confirmez qu’elle correspond exactement au nom public sur l’onglet Models — pas à votre ID de modèle local Ollama/llama.cpp/vLLM/LM Studio.
Le connecteur pour ce déploiement est hors ligne ou a atteint sa limite de concurrence. Vérifiez l’onglet Connectors — le connecteur doit afficher Online.
Ce n’est généralement pas une erreur Tokios — c’est un signe que le modèle derrière votre déploiement ne prend pas en charge l’appel d’outils natif. Voir Choisir un modèle qui prend en charge l’appel d’outils ci-dessus.

​
Prochaines étapes

Choisir un modèle local

Comparez les modèles et les backends pour les charges de travail de l’agent de codage comme Roo Code.

Clients compatibles

Consultez la configuration de l’URL de base et de la clé pour les autres clients compatibles OpenAI et Anthropic.