Cline est une extension d'agent de programmation IA open source, couramment utilisée dans la barre latérale de VS Code pour lire le code, modifier des fichiers et exécuter des commandes. Elle n'est pas liée à un fournisseur unique : outre le compte Cline, vous pouvez choisir une interface compatible OpenAI dans API Provider et renseigner votre Base URL, votre clé et votre identifiant de modèle. Pour une équipe, cela permet de brancher Cline sur une passerelle commune et de centraliser les clés, l'usage et les modèles.

Cet article suit l'ordre installation, configuration, validation et déploiement en équipe ; Cline évolue vite, les boutons et noms de champs suivent les réglages de la version actuelle.

Note : Cline est une marque de Cline Bot Inc. Cet article n'est qu'une explication technique et n'implique aucune affiliation, représentation ni approbation de Cline Bot Inc. ; les fonctions, l'interface et les règles de facturation font foi dans la documentation officielle de Cline.

1. Trois éléments à préparer

L'intégration personnalisée de Cline ne demande que trois informations : une adresse compatible, une clé API et un identifiant de modèle exact. Préparez-les côté passerelle avant d'ouvrir l'éditeur.

  1. Ouvrez la page d'inscription à la passerelle ZSQH AI, inscrivez-vous et connectez-vous à la console.
  2. Allez dans « Clés API », créez une clé et indiquez l'utilisateur et l'appareil, par exemple cline-zhang-macbook.
  3. Définissez si besoin un plafond et une date d'expiration. Même pour un test personnel, fixez-les pour éviter une consommation anormale.
  4. Copiez la clé dans un gestionnaire de mots de passe ; la console ne l'affiche généralement en entier qu'une fois.
  5. Ouvrez la page tarifs des modèles et copiez l'identifiant du modèle à utiliser. Modèles et prix évoluent : la page actuelle fait foi.

Consignez les trois informations comme suit, pour faciliter le diagnostic et la passation :

Base URL: https://ai.zhongshangqihang.com/v1
API Key: sk-... (uniquement dans le gestionnaire de mots de passe)
Model: identifiant affiché actuellement sur la page « tarifs des modèles »
Context Window: selon les spécifications officielles du modèle

La Base URL est une adresse compatible OpenAI se terminant par /v1. Ne mettez pas la page d'accueil du site et n'ajoutez pas /chat/completions, sous peine de chemin dupliqué et de 404.

2. Installer Cline dans VS Code

L'installation est simple ; ce sont la confiance accordée à l'espace de travail et les droits qui posent problème ensuite.

  1. Ouvrez VS Code et appuyez sur Cmd/Ctrl + Shift + X pour afficher les extensions.
  2. Recherchez Cline, vérifiez l'éditeur et cliquez sur Install.
  3. Une fois installé, ouvrez l'icône Cline dans la barre d'activité de gauche.
  4. À la première ouverture, la page de configuration propose d'utiliser votre propre clé API ; selon la version, le libellé peut être Use your own API key.
  5. N'activez l'outil que dans des dossiers de confiance. Sur un dépôt inconnu, ne laissez pas l'agent exécuter des commandes avec l'approbation automatique activée.

Les entrées d'installation de Cursor, Windsurf et VSCodium sont similaires, mais les places de marché d'extensions peuvent différer ; cet article se réfère à VS Code.

3. Choisir un fournisseur compatible OpenAI

Ouvrez l'icône d'engrenage en haut à droite du panneau Cline et sélectionnez OpenAI Compatible dans la liste API Provider. C'est la clé de l'intégration à une passerelle générique.

Ne saisissez pas une clé de passerelle dans les champs dédiés OpenAI, Anthropic ou Google : ces fournisseurs ont leurs propres points d'accès et méthodes d'authentification par défaut, et une erreur produit souvent 401, 404 ou un échec de connexion. Sauf si la passerelle expose explicitement le protocole natif correspondant, choisissez OpenAI Compatible.

Use Azure Identity Authentication ne concerne que les identités managées Azure ; ne la cochez pas pour une clé de passerelle ordinaire.

Choisir le fournisseur propre à Cline consomme le quota du compte Cline ; choisir OpenAI Compatible avec votre clé envoie les requêtes vers votre passerelle, qui gère la facturation. Ne mélangez pas les deux lors du diagnostic.

4. Renseigner Base URL, clé et modèle

Les trois champs principaux se remplissent ainsi :

Champ Contenu Attention
Base URL https://ai.zhongshangqihang.com/v1 Conserver /v1, sans /chat/completions
API Key la clé sk-... créée dans la console Une clé par personne, non partagée avec d'autres outils
Model l'identifiant de modèle de la page des tarifs Copier tel quel, attention à la casse et au suffixe de version
Model Configuration fenêtre de contexte, sortie maximale, etc. Renseigner les spécifications réelles, sans surestimer
Azure Identity laisser décoché Réservé aux identités managées Azure

Model est un identifiant de routage, pas un nom d'affichage. Un suffixe de version manquant ou une casse différente peut renvoyer Model Not Found. Si la liste déroulante ne propose pas le modèle, il est souvent possible de saisir directement l'identifiant, selon ce que la version permet.

Les champs Max Output Tokens, Context Window, Image Support, Computer Use et les prix de Model Configuration servent surtout à Cline pour gérer le contexte et estimer les coûts ; ils ne constituent pas la base de facturation de la passerelle. Une fenêtre de contexte trop grande fait surestimer l'espace disponible à l'agent, et la passerelle finit par signaler un dépassement. Renseignez les spécifications réelles du modèle.

Si le modèle ne prend pas en charge les appels d'outils, les capacités de l'agent — lecture et écriture de fichiers, exécution de commandes — sont limitées ; les images et le contrôle d'ordinateur dépendent aussi des capacités du modèle.

5. Vérifier que la configuration est réellement active

Le succès de Verify indique seulement que l'adresse, la clé et le nom du modèle sont globalement corrects, pas que toutes les capacités d'appel d'outils fonctionnent. Faites une validation réelle :

  1. Créez une tâche vide pour éviter l'interférence de l'historique.
  2. Sélectionnez explicitement le modèle configuré, sans sélection automatique.
  3. Envoyez une demande en lecture seule, par exemple expliquer un petit fichier du répertoire courant.
  4. Ouvrez les journaux d'usage ou de requêtes de la console de la passerelle et vérifiez la présence d'une entrée à la même heure, avec le même modèle et la même clé.
  5. Demandez ensuite une petite modification sans écriture de fichier, pour observer si une approbation est demandée et si l'opération réussit.

Correspondances d'erreurs courantes :

  • Invalid API Key ou 401 : clé erronée, désactivée, ou espace et retour à la ligne introduits au copier-coller.
  • 403 : droits insuffisants, quota épuisé ou modèle hors du périmètre ouvert.
  • 404 ou Model Not Found : chemin de Base URL ou identifiant de modèle incorrect.
  • 429 : limitation de débit ou plafond de quota de la clé atteint.
  • Délai : point d'accès injoignable ou problème de chemin réseau.
  • Conversation normale mais actions d'agent en échec : soupçonnez d'abord un modèle sans appels d'outils, pas une clé invalide.

6. Régler les droits d'approbation automatique

L'approbation automatique (Auto Approve) se contrôle par catégorie : lecture, édition, commandes terminal, navigateur, outils MCP. Chaque catégorie peut être activée séparément ; certaines distinguent « commandes sûres uniquement » et « toutes les commandes ».

Il est conseillé d'ouvrir seulement la lecture des fichiers du projet, en laissant désactivés l'édition, le terminal, le navigateur et MCP. Une fois le flux stabilisé, ouvrez les catégories une par une ; en activant l'édition, activez aussi les Checkpoints pour pouvoir revenir en arrière.

Les commandes terminal sont les plus risquées. Cline n'utilise pas de liste blanche fixe : le modèle juge selon la commande et ses paramètres ; build, tests et git status sont généralement considérés comme sûrs, tandis que npm install, rm -rf, mv et sed -i demandent souvent confirmation. Ce jugement n'est pas une frontière de sécurité et ne remplace pas une relecture humaine.

Le mode YOLO contourne toutes les confirmations, y compris les modifications de fichiers, les commandes terminal, le navigateur et les appels MCP ; la documentation officielle en signale explicitement les risques. Pour l'essayer, utilisez un dépôt jetable ou un bac à sable, avec une sauvegarde Git préalable. Les Checkpoints aident au retour arrière, mais ne sont ni une sauvegarde ni une protection pour les opérations hors dépôt.

7. Déployer en équipe

  • Commencez par un pilote restreint : trois à cinq développeurs, un modèle principal commun, une semaine d'utilisation.
  • Relevez le taux de réussite des requêtes, la latence moyenne et la consommation quotidienne par personne.
  • Créez une clé distincte par personne sur la passerelle, avec quota et expiration, sans clé partagée.
  • Tenez une table de correspondance des modèles : ce qui est saisi dans Cline, ce que la passerelle associe, et la bascule en cas d'échec.
  • Documentez en interne la Base URL, les identifiants de modèle, les réglages de droits et les erreurs courantes.
  • Uniformisez la source et la version de l'extension pour éviter les paquets modifiés d'origine inconnue.
  • Placez les conventions du projet dans les fichiers de règles du dépôt. Les versions récentes utilisent le répertoire .cline/, les plus anciennes .clinerules ; référez-vous à la documentation de la version utilisée. Ne mettez jamais de secret dans les fichiers de règles.
  • En cas de départ, de changement de machine ou de fin de projet, désactivez la clé correspondante le jour même.

Le calcul de coût s'appuie sur la page tarifs des modèles et doit se faire à partir du volume réel de requêtes et de la longueur du contexte, pas d'une impression subjective sur une tâche isolée.

8. Sécurité et frontière des données

  • La clé peut être stockée dans un fichier de configuration local. Les versions récentes placent la configuration des fournisseurs dans ~/.cline/data/settings/providers.json, qui peut contenir la clé. Ne la versionnez pas et ne la synchronisez pas vers un cloud public.
  • Activez le chiffrement du disque et limitez les droits locaux. Sur un ordinateur partagé, ne conservez pas de clé durable.
  • L'agent lit les fichiers de l'espace de travail. Excluez .env, les identifiants et les clés privées du périmètre lisible ; si la version permet de configurer des fichiers ignorés, faites-le et vérifiez.
  • Les serveurs MCP, plugins et hooks peuvent exécuter du code ou accéder au réseau : n'installez que des sources fiables et lisez les descriptions de droits.
  • L'approbation automatique amplifie le risque d'injection de prompt. Quand l'agent lit une page web, une issue ou un dépôt inconnu, des instructions malveillantes peuvent l'inciter à exécuter des commandes. Conservez une confirmation humaine pour les opérations terminal et réseau.
  • Vérifiez d'abord si les données quittent la machine et vers quels services, avant de décider quels dépôts sont acceptés ; évaluez les projets sensibles au préalable.

9. Questions fréquentes

Cline peut-il se connecter à n'importe quelle interface compatible OpenAI ?

Dans la plupart des cas, oui, à condition que l'interface soit compatible avec les chemins et paramètres réellement appelés par Cline, et que le modèle prenne en charge les appels d'outils. Validez d'abord avec un chat simple, puis testez l'édition de fichiers et les opérations terminal.

Faut-il saisir l'adresse racine ou l'adresse avec /v1 ?

Avec le protocole compatible OpenAI, saisissez l'adresse jusqu'à /v1, par exemple https://ai.zhongshangqihang.com/v1 ; n'ajoutez pas /chat/completions, sinon le chemin est dupliqué.

Verify réussit mais les tâches échouent : pourquoi ?

Regardez d'abord le code d'erreur et les journaux de la passerelle. Les causes fréquentes sont un modèle sans appels d'outils, une fenêtre de contexte inexacte, un quota insuffisant ou une limitation de débit. Verify ne valide que la connectivité de base, pas toutes les capacités.

Quelle différence entre le compte Cline et votre propre clé ?

Le compte Cline consomme le quota côté Cline ; avec votre clé, les requêtes partent vers la passerelle que vous indiquez, qui facture et journalise. La plage de modèles, le chemin des données et la méthode de diagnostic diffèrent.

Une équipe peut-elle partager une clé ?

Techniquement oui, mais ce n'est pas recommandé. Une clé partagée ne permet pas de distinguer les usages et reste difficile à localiser et à limiter en cas de fuite. Une clé par personne, avec quota, expiration et journaux, est plus fiable.

Étape suivante

Inscrivez-vous à la passerelle ZSQH AI, créez une clé dédiée à Cline, puis renseignez la Base URL et le modèle comme ci-dessus. Une fois les tâches en lecture seule validées, ouvrez progressivement l'édition et le terminal, et ajustez le modèle principal et les quotas selon la page tarifs des modèles.

Lecture associée :