Qu’est-ce que Cline AI ? Installation dans VS Code, configuration API et usage sécurisé

Cline — également recherché sous les noms Cline AI, ClineAI ou Cline agent — est un agent de programmation open source qui fonctionne dans l’éditeur et le terminal. Dans VS Code, il peut lire les fichiers du projet, rechercher du code, modifier des fichiers, exécuter des commandes, utiliser un navigateur et appeler des outils MCP, tout en respectant les permissions que vous avez définies. Cline n’est pas un modèle de langage : il se connecte à un fournisseur et utilise le modèle choisi pour raisonner et générer du code.

Ce guide explique ce qu’est Cline, comment l’installer dans VS Code, comment connecter votre propre API avec le mode OpenAI Compatible et comment vérifier la configuration sans accorder trop de droits. L’exemple utilise BetterToken, mais la logique s’applique aussi à d’autres endpoints compatibles.

L’essentiel

• Cline est un agent de programmation, pas un modèle.
• Après l’installation de l’extension, vous pouvez utiliser l’accès aux modèles proposé par Cline ou fournir votre propre API Key.
• Avec BetterToken, sélectionnez OpenAI Compatible et utilisez https://www.bettertoken.ai/v1 comme Base URL.
• Commencez en lecture seule. N’activez pas immédiatement les modifications automatiques, les commandes, le navigateur, MCP ou YOLO Mode.

Le rôle de Cline, de VS Code et de l’API du modèle

Une tâche Cline classique comporte trois couches :

1. VS Code affiche le projet, la conversation, les diff, la sortie du terminal et les demandes d’autorisation.
2. L’agent Cline rassemble le contexte, choisit les outils, organise les étapes et vérifie vos permissions.
3. L’API du modèle reçoit le contexte et renvoie une analyse, du code ou une proposition d’appel d’outil.

Le résultat ne dépend donc pas uniquement de l’extension. Le modèle influence la qualité du raisonnement et du code, la vitesse, la taille du contexte et le coût. Les réglages de Cline déterminent quels fichiers et outils sont accessibles et quelles actions nécessitent votre accord.

C’est la principale différence avec un simple chat dans l’éditeur. Un chat génère surtout du texte. Cline fonctionne dans une boucle d’agent : lire les informations, proposer l’étape suivante, utiliser un outil, analyser le résultat, puis continuer jusqu’à la fin de la tâche ou jusqu’à ce qu’une décision soit nécessaire.

Comment installer Cline dans VS Code

1. Ouvrez VS Code.
2. Appuyez sur Ctrl/Cmd + Shift + X pour ouvrir Extensions.
3. Recherchez Cline et sélectionnez l’extension officielle Cline.
4. Cliquez sur Install.
5. Ouvrez Cline depuis l’Activity Bar.
6. Sur l’écran d’accueil, choisissez Use your own API key pour configurer un fournisseur personnalisé.

Si l’icône n’apparaît pas après l’installation, lancez Developer: Reload Window ou redémarrez complètement VS Code. Les libellés peuvent varier légèrement selon la version, mais les paramètres du Provider et du modèle restent accessibles dans la barre latérale de Cline.

Ce qu’il faut préparer avant de connecter l’API

Pour relier Cline à BetterToken, préparez :

• un compte BetterToken ;
• une API Key dédiée ;
• un Model ID actuel copié depuis la page des modèles et tarifs ;
• un réseau capable d’atteindre l’endpoint ;
• des versions à jour de VS Code et de l’extension Cline.

Traitez l’API Key comme un mot de passe. Ne la commitez pas dans un dépôt et ne l’exposez pas dans une capture, un log, une issue ou un fichier public. En équipe, créez des clés séparées par utilisateur ou environnement pour faciliter les limites, la révocation et le suivi des requêtes.

Configurer l’API BetterToken dans Cline

Ouvrez les paramètres de Cline et renseignez :

Champ	Valeur
API Provider	OpenAI Compatible
Base URL	https://www.bettertoken.ai/v1
API Key	Votre API Key BetterToken
Model	Le Model ID actuel et exact de la page des modèles

Points importants :

1. La Base URL est https://www.bettertoken.ai/v1. N’ajoutez pas /chat/completions, /responses ou un autre chemin de méthode.
2. Copiez exactement le Model ID depuis la liste actuelle, pas depuis un ancien article ou une capture obsolète.
3. Un User-Agent ou des Header personnalisés ne sont généralement pas nécessaires. Ajoutez-les uniquement si la documentation officielle du service upstream l’exige.
4. Tous les modèles n’utilisent pas forcément le même protocole. Vérifiez la compatibilité actuelle dans la documentation BetterToken pour Cline.

Si vous aviez défini des variables OpenAI et que Cline continue d’utiliser une ancienne adresse, supprimez-les de la session macOS ou Linux courante :

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Sous Windows PowerShell :

Remove-Item Env:OPENAI_API_KEY -ErrorAction SilentlyContinue
Remove-Item Env:OPENAI_BASE_URL -ErrorAction SilentlyContinue

Enregistrez avec Done, puis rechargez Cline. Après un changement de Base URL, de clé ou de modèle, créez une nouvelle tâche afin qu’une ancienne session ne conserve pas des paramètres dépassés ou un contexte trop volumineux.

Première requête : commencez par un test en lecture seule

Ne commencez pas par « refactorise tout le projet ». Ouvrez un fichier de code ordinaire et envoyez ce prompt :

Lis uniquement le fichier actuellement ouvert. Explique son objectif, ses principales entrées et ses sorties. Ne modifie aucun fichier et n’exécute aucune commande dans le terminal.

Le premier test est réussi si :

• Cline répond à partir du contenu du fichier ;
• aucune erreur d’authentification, de modèle ou de connexion n’apparaît ;
• aucun fichier n’est modifié et aucune commande n’est exécutée ;
• la requête et la consommation de Token apparaissent dans BetterToken Dashboard.

Si Cline répond mais que le Dashboard ne contient aucune requête, vérifiez que le Provider actif est bien OpenAI Compatible, puis contrôlez la Base URL, l’API Key, le Model ID et le proxy réseau. Ne publiez jamais la clé complète dans une capture destinée au support.

Comment Cline exécute une tâche de code

Le cycle habituel est le suivant :

1. Vous définissez le résultat, le périmètre autorisé et les critères de fin.
2. Cline lit les fichiers pertinents et recherche le code associé.
3. Le modèle propose l’étape suivante : lire, modifier, lancer un test ou poser une question.
4. Cline vérifie la catégorie de permission et demande votre accord si nécessaire.
5. Le résultat de l’outil rejoint le contexte et le modèle décide de la suite.
6. Vous contrôlez le diff final, la sortie des commandes et les tests.

Pour un travail peu clair, commencez en Plan Mode. Cline peut explorer et discuter le code, mais il ne modifie pas les fichiers et n’exécute pas de commandes. Une fois l’approche validée, passez en Act Mode.

Exemple en Plan Mode :

Analyse pourquoi l’endpoint de connexion renvoie parfois HTTP 500. Lis uniquement le code et les tests concernés. Liste les causes les plus probables, les fichiers touchés et la correction minimale et sûre. Ne modifie pas le code.

Après validation du plan, passez en Act Mode :

Applique la correction minimale approuvée. Modifie uniquement l’endpoint de connexion et les tests directement liés. Lance les tests les plus pertinents et arrête-toi lorsqu’ils passent. Ne refactorise pas les autres modules.

Cette demande est beaucoup plus facile à vérifier qu’un simple « corrige la connexion ».

Permissions recommandées pour les premières tâches

Commencez avec un profil prudent :

Permission	Recommandation initiale
Read project files	Activé
Read all files / hors workspace	Désactivé
Edit project files	Confirmation à chaque fois, ou désactivé au départ
Execute safe commands	Confirmation manuelle pour les premières tâches
Execute all commands	Désactivé
Use the browser	À activer uniquement pour un besoin précis
Use MCP servers	À activer après validation d’un serveur précis
YOLO Mode	Désactivé dans les vrais projets

Avant d’accepter une commande, vérifiez ses arguments, son répertoire de travail et les fichiers visés. npm test et npm install n’ont pas les mêmes conséquences ; git status et git push non plus.

Checkpoints et Git peuvent annuler des modifications locales, mais pas une requête réseau déjà envoyée, une suppression de données distantes ou la fuite d’un secret. Pour un dépôt important, utilisez une branche ou un worktree et gardez les fichiers sensibles hors de portée de l’agent lorsque c’est possible.

API, MCP et Cline Rules ont des rôles différents

Ces notions sont souvent confondues :

• L’API du modèle fournit le raisonnement et la génération.
• MCP ajoute des outils et des sources externes, par exemple des bases de données, des services hébergés ou des systèmes internes.
• Cline Rules décrit les conventions de code, les limites d’architecture, les exigences de test et les pratiques du projet.

MCP ne remplace pas l’API du modèle. L’ordre le plus fiable consiste à connecter l’API et réussir un test en lecture seule, puis ajouter les règles du projet, et enfin connecter uniquement des serveurs MCP de confiance pour une tâche définie. Stockez les identifiants MCP dans des variables d’environnement ou un coffre sécurisé.

Comment fonctionne le coût de Cline

Cline est open source, mais l’exécution du modèle consomme des ressources. Cline propose plusieurs modes d’accès, dont une facturation intégrée, des abonnements et BYOK. BetterToken correspond à une configuration avec votre propre API, donc le coût dépend des requêtes envoyées au modèle choisi.

La consommation peut inclure :

• input tokens : prompts, fichiers, règles et historique ;
• output tokens : réponses, code et contenu des tool calls ;
• cache tokens : uniquement si le modèle et l’endpoint prennent le cache en charge.

Le coût affiché dans Cline est généralement une estimation. Utilisez la facture du fournisseur ou BetterToken Dashboard comme référence finale. Pour limiter les dépenses inutiles :

• donnez un seul objectif vérifiable à chaque tâche ;
• ne chargez pas tout le dépôt sans raison ;
• recherchez et lisez avant de demander de grands changements ;
• créez une nouvelle tâche lorsque le sujet change ;
• vérifiez le tarif actuel avant une longue exécution ;
• utilisez un modèle plus rapide et moins cher pour les travaux simples si son tool calling est fiable ;
• planifiez les changements importants avant de les exécuter afin d’éviter les reprises.

Erreurs fréquentes et solutions

Symptôme	À vérifier en premier
401, Unauthorized ou Invalid API Key	Clé correcte, espaces au début/à la fin et éventuelle révocation
404	Base URL exactement https://www.bettertoken.ai/v1, sans suffixe d’endpoint
model not found	Model ID actuel, avec la casse et les signes exacts
L’ancienne configuration reste active	Enregistrer, recharger l’extension ou VS Code, puis créer une nouvelle tâche
Échecs de connexion répétés	Réseau local, proxy, firewall et DNS vers l’endpoint
Réponse présente, Dashboard vide	Provider actif, compte, anciennes variables et Base URL
Sortie étrange ou échec des tools	Modèle adapté à l’agent/tool calling et paramètres exacts
Consommation de Token trop rapide	Contexte excessif, historique trop long ou relecture des mêmes fichiers

Modifiez une variable à la fois. Confirmez d’abord Provider, Base URL, clé et Model, puis seulement la fenêtre de contexte, la limite de sortie, les Header ou le proxy.

Les tâches adaptées à Cline

Cline est particulièrement utile pour :

• comprendre un module inconnu et localiser les fichiers associés ;
• corriger un Bug limité avec des étapes de reproduction ou un test existant ;
• appliquer un changement cohérent dans plusieurs fichiers ;
• lancer lint, build ou tests et expliquer un échec ;
• implémenter une fonctionnalité bien délimitée selon les patterns existants ;
• appeler des outils MCP avec une politique d’accès explicite.

Exemple de prompt pratique :

Objectif : ajouter un filtre par statut à la liste des commandes.
Périmètre autorisé : la page de liste, les paramètres de requête directement utilisés et les tests associés.
À ne pas faire : ne pas refactoriser le module des commandes, ne pas mettre à jour les dépendances et ne pas modifier la logique de paiement.
Critères de fin : l’utilisateur peut choisir un statut et voir les bons résultats ; le filtre reste actif après actualisation de la page.
Vérification : lancer les tests de la liste des commandes et s’arrêter lorsqu’ils passent.

Cline peut être inutile pour une question d’une ligne. Il ne faut pas lui donner un accès illimité à un dépôt très sensible sans isolation ni règles. Pour des workflows fixes, répétitifs et sans surveillance, une intégration CLI ou CI est souvent plus adaptée que de garder VS Code ouvert.

Questions fréquentes

Qu’est-ce que Cline AI ?

Cline est un agent de programmation open source pour les éditeurs et le terminal. Il peut lire du code, modifier des fichiers, exécuter des commandes, utiliser le navigateur et appeler MCP. Une API externe fournit le raisonnement, tandis que les permissions gardent les actions sous le contrôle de l’utilisateur.

ClineAI, Cline agent et Cline désignent-ils le même outil ?

Dans les recherches, ces termes désignent généralement le même agent. Le nom officiel du produit est Cline.

Cline fonctionne-t-il dans VS Code ?

Oui. L’extension officielle s’ouvre dans la barre latérale de VS Code et affiche la conversation, les diff, l’état de la tâche et les demandes d’autorisation.

Comment connecter ma propre API à Cline ?

Choisissez le Provider approprié dans les paramètres. Pour BetterToken, sélectionnez OpenAI Compatible, saisissez https://www.bettertoken.ai/v1, votre API Key et le Model ID actuel exact, puis enregistrez et rechargez l’extension.

Faut-il un abonnement Cline ?

Pas nécessairement. Cline accepte plusieurs modes d’accès aux modèles, dont ses propres offres et les API Keys externes. Le meilleur choix dépend du compte, de la région, des modèles et du budget.

Quelle différence entre Cline et MCP ?

Cline est l’agent qui exécute la tâche, l’API du modèle fournit l’intelligence et MCP ajoute des outils et des données externes. Ce sont des couches complémentaires.

Cline est-il sûr ?

Cela dépend des permissions, du prompt, du modèle, des serveurs MCP et de l’environnement. Le moindre privilège, la vérification des commandes, Git, l’isolation des secrets et YOLO Mode désactivé par défaut réduisent fortement le risque.

Conclusion

Cline est plus qu’un chat dans VS Code. Il réunit le contexte du projet, les modifications, les commandes et les diff vérifiables dans un même workflow d’agent. La bonne méthode consiste à installer l’extension officielle, connecter une API, réussir un test en lecture seule, puis n’élargir les permissions d’édition, de terminal, de navigateur et MCP qu’en cas de besoin réel.

Avec BetterToken, utilisez OpenAI Compatible, la Base URL https://www.bettertoken.ai/v1, votre API Key et un Model ID valide et actuel. Commencez par une petite tâche précise et considérez chaque nouvelle permission comme une décision explicite.

Pour aller plus loin :

• Présentation officielle de Cline
• Guide d’installation de Cline
• Configuration OpenAI Compatible dans Cline
• Guide BetterToken pour Cline
• Créer un compte BetterToken