Qu’est-ce que Cline pour VS Code ?
Cline est un agent de codage open source pour VS Code qui peut utiliser une API personnalisée compatible OpenAI pour lire le code, proposer des modifications et exécuter des outils approuvés.
Cette configuration Cline VS Code conserve les informations d'identification de votre fournisseur et la sélection de modèle dans les propres paramètres de Cline, puis vérifie la connexion avec une tâche de codage en lecture seule avant que tout accès en écriture ne soit approuvé. Cline combine les réponses du modèle avec l'accès aux fichiers, les commandes du terminal, les actions du navigateur et les contrôles d'approbation dans l'éditeur. Une réponse de chat réussie n'est qu'une première vérification : utilisez un espace de travail de test, laissez l'approbation automatique désactivée au départ et vérifiez l'appel de l'outil natif avant de vous fier au modèle pour des modifications ou de longues tâches autonomes.
Cline 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 Cline 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 | Cline settings panel |
| 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.
Enregistrez le provider TokenHub dans l’interface de l’outil. Si l’outil sépare Chat, Edit, Apply, Fast ou Autocomplete, pointez tous les emplacements vers TokenHub pour le premier test.
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 sur l'API Cline pour VS Code
Où dois-je enregistrer la configuration TokenHub dans Cline ?
Enregistrez-le via le panneau des paramètres du fournisseur d'API de Cline. La documentation de l'équipe peut partager l'URL de base et l'ID du modèle, mais jamais une véritable clé API.
Pourquoi Cline peut-il répondre aux questions mais pas modifier les fichiers ?
Confirmez d'abord que le modèle prend en charge l'utilisation de l'outil, puis vérifiez les autorisations d'écriture de fichiers et les paramètres d'approbation de Cline. Une réponse textuelle prouve uniquement que la connexion de base fonctionne.
Pourquoi le prestataire a-t-il changé après la réouverture d'un espace de travail ?
La configuration au niveau de l'espace de travail peut remplacer les paramètres utilisateur. Vérifiez que le fournisseur actif, l'URL de base et l'ID de modèle pointent toujours vers TokenHub.
Comment sont calculés les coûts de l’API Cline ?
L'API d'extension et de modèle sont des couches de facturation distinctes. TokenHub facture en fonction du jeton réel du modèle sélectionné et de l'utilisation du cache applicable au prix actuel de la page du modèle.
Que font les règles Cline et .clinerules ?
Ils fournissent des conventions de projet, des contraintes de commande et des conseils sur le flux de travail. Ils ne remplacent pas la configuration de l'URL de base du fournisseur, de la clé API ou de l'ID de modèle.
Références
Cette configuration s’appuie sur TokenHub et la documentation officielle ; dernière vérification : 2026-09-04。
