Configuration des Coding Agents

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

Installez Cline, configurez la Base URL et l’API Key BetterToken, choisissez un modèle compatible et résolvez les erreurs fréquentes. Avec plus de détails.

Pour connecter Cline à BetterToken, préparez une API Key, saisissez la Base URL ci-dessous et choisissez un Model ID actuel dans le model plaza. Pour des interfaces proches, consultez aussi Roo Code, Kilo Code et MonkeyCode.

Paramètres principaux

Champ	Valeur
API Key	Utiliser la BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Modèle	Un Model ID actuel provenant du model plaza

Prérequis

La version actuelle de l’outil est installée
Une BetterToken API Key : créez un compte et obtenez-en une
Un Model ID provenant du model plaza

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.

Prérequis supplémentaires

VS Code est installé

Installation

Installer Cline

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

Configuration manuelle

Effectuez cette configuration dans l’interface de Cline. Aucun fichier de configuration ne doit être modifié.

Champ	Valeur
API Key	Utiliser la BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Modèle	Un Model ID actuel provenant du model plaza

Configuration

Supprimer les variables d’environnement conflictuelles

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Ouvrir la configuration de Cline

Cliquez sur Use your own API key dans la barre latérale de Cline.

Configurer le fournisseur API

Renseignez :

API Provider → OpenAI Compatible
Base URL → https://bettertoken.ai/v1
API Key → votre BetterToken API Key
Model → un Model ID provenant d’un fournisseur pris en charge, copié depuis le model plaza

Dans Model Configuration, utilisez les limites de contexte et de sortie confirmées du modèle choisi. Activez les images ou Computer Use uniquement si le modèle et l’endpoint les prennent en charge ; consultez les paramètres de fournisseur de Cline.

Configurer des headers supplémentaires uniquement s’ils sont exigés

La documentation officielle de Cline pour une configuration compatible avec OpenAI se concentre sur la Base URL, l’API Key et le Model ID. Aucun User-Agent supplémentaire n’est généralement nécessaire pour connecter BetterToken.

Si vous utilisez également une gateway personnalisée, un routage des tenants, une couche d’observabilité ou de Cache, ajoutez des headers uniquement conformément à la documentation officielle de ce service upstream.

Enregistrer la configuration

Cliquez sur Done.

Redémarrer Cline

Après l’enregistrement, redémarrez VS Code ou rechargez l’extension Cline pour appliquer les nouveaux paramètres.

Vérifier la connexion

Utilisez Verify dans les paramètres du fournisseur pour vérifier la connexion.

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

CLI Cline

Installez le CLI Cline officiel séparément de l’extension VS Code. Lors d’un test sur macOS avec un modèle GPT, Cline CLI 3.0.73 a traité des requêtes texte et des appels d’outils de lecture de fichiers.

Remplacez YOUR_API_KEY par votre BetterToken API Key et YOUR_MODEL_ID par un ID exact du model plaza, puis authentifiez-vous :

cline auth --provider openai --apikey YOUR_API_KEY --baseurl https://bettertoken.ai/v1 --modelid YOUR_MODEL_ID

Exécutez un test texte sans interface :

cline --json --retries 2 --timeout 170 --provider openai --model YOUR_MODEL_ID "Reply with only: OK"

Vérifiez que la réponse finale contient OK. Lors des tests, --provider openai a été enregistré comme openai-compatible ; la valeur de la ligne de commande diffère du libellé OpenAI Compatible du menu de l’IDE. Si vous utilisez --data-dir pour choisir un répertoire de configuration, indiquez le même répertoire dans les deux commandes.

Changer de modèle

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

Erreurs fréquentes

Erreur	Vérification
`401` ou `Unauthorized`	Vérifiez la BetterToken API Key et supprimez les espaces au début ou à la fin.
`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 de l’endpoint compatible avec OpenAI. N’ajoutez ni /chat/completions ni /responses, sauf si un champ l’exige explicitement.