Pour connecter un modèle personnalisé dans Cline, la clé est à la fois un laissez-passer et une frontière de coût et de sécurité. Une clé créée sans soin entraîne souvent une consommation anormale du quota, un usage impossible à imputer, une ancienne clé encore active après un départ, voire une clé qui finit dans une sauvegarde ou un dépôt avec le fichier de configuration.

Cet article suit l'ordre « création — multi-modèles — stockage — rotation — droits — équipe — dépannage » ; l'interface et le mode de stockage peuvent changer selon les versions, référez-vous à la version actuelle et à la documentation officielle.

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. ; fonctions, interface et règles de facturation font foi dans la documentation officielle de Cline.

1. Distinguer ce que désigne « clé API Cline »

L'expression recouvre souvent trois choses :

  • Identifiant de la plateforme Cline : pour le compte ou les interfaces de la plateforme Cline, avec un quota décidé côté Cline.
  • Clé de fournisseur de modèle : émise par OpenAI, Anthropic, Google, etc., et saisie dans le champ du fournisseur correspondant.
  • Clé de passerelle : émise par un service compatible comme la passerelle ZSQH AI, souvent préfixée sk-, et appelant plusieurs modèles via le protocole compatible OpenAI.

Cet article traite du troisième cas. Elle ne sert pas à se connecter à Cline et ne permet pas d'appeler les interfaces de la plateforme Cline. La bonne entrée est OpenAI Compatible, et non les champs dédiés OpenAI, Anthropic ou Azure.

2. Créer une clé : définir le périmètre avant de copier

Avant de créer, répondez à trois questions : pour qui, sur quel projet, et quelle consommation maximale prévoir.

  1. Ouvrez la page d'inscription à la passerelle ZSQH AI et connectez-vous à la console.
  2. Allez dans « Clés API » et créez une clé.
  3. Le nom contient l'utilisateur, l'appareil et l'usage, par exemple cline-zhang-macbook-daily, pas seulement test.
  4. Définissez un plafond et une date d'expiration ; si la console permet de restreindre les modèles, limitez-les par projet.
  5. Vérifiez le solde et le quota pour éviter de découvrir après configuration que les appels sont impossibles.
  6. Copiez la clé dans un gestionnaire de mots de passe, sans l'envoyer d'abord dans un outil de chat ou un ticket.

Consignez-la de la manière suivante, pour faciliter rotation et passation :

Usage: cline-zhang-macbook-daily
Base URL: https://ai.zhongshangqihang.com/v1
Key: sk-... (uniquement dans le gestionnaire de mots de passe)
Modèle: identifiant affiché actuellement sur la page « tarifs des modèles »
Quota: selon le budget du projet
Expiration: 2027-01-31

La clé n'est généralement affichée en entier qu'une fois ; en cas de perte, créez-en une nouvelle et désactivez l'ancienne. Modèles et prix évoluent : référez-vous à tarifs des modèles.

3. Configurer plusieurs modèles

Dans l'extension VS Code, API Provider, Base URL et modèle forment généralement une configuration active ; changer de modèle passe par les réglages ou le sélecteur de tâche. La possibilité d'enregistrer plusieurs configurations par projet dépend de la version et de la documentation.

La gestion multi-modèles la plus robuste se fait côté passerelle : des clés différentes selon les scénarios, avec plafonds, périmètre de modèles et journaux pour distinguer les usages. Ainsi, même si la configuration d'une machine est modifiée, l'impact reste maîtrisé.

Scénario Niveau de modèle Stratégie de clé Attention
Questions quotidiennes, petites modifications Modèle léger et rapide Clé personnelle Coût faible, capacités limitées sur les tâches complexes
Modification principale, tâches d'agent Modèle de code principal Clé personnelle Doit prendre en charge les appels d'outils
Architecture, diagnostic difficile Modèle de forte capacité Clé de projet, approbation au besoin Coût plus élevé, usage à encadrer
Automatisation, CI, scripts Modèle de version stable Clé de service dédiée Quota séparé, sans mélange avec les clés personnelles
Test temporaire Modèle économique Clé à durée courte Expiration la plus proche possible

En ligne de commande, cline auth permet de configurer fournisseur, clé, modèle et Base URL ; les paramètres peuvent varier selon la version, consultez l'aide locale avant usage :

export ZSQH_API_KEY="sk-... (injecté depuis le gestionnaire de mots de passe, jamais écrit dans le script)"
cline auth -p <provider-id> -k "$ZSQH_API_KEY" \
  -m <model-id> -b https://ai.zhongshangqihang.com/v1

Notez que la clé passée à -k peut être enregistrée comme configuration persistante du fournisseur. N'utilisez cette commande que sur une machine de confiance, et vérifiez que l'historique du shell, la liste des processus et les journaux ne conservent pas de texte en clair. La CLI permet d'isoler le répertoire de configuration avec --config, --data-dir, CLINE_DIR ou CLINE_DATA_DIR.

4. Où est stockée la clé

Les versions récentes placent les réglages globaux sous ~/.cline/data/settings/ :

  • providers.json : configuration des fournisseurs, qui contient les clés API selon la documentation officielle.
  • global-settings.json : réglages globaux généraux.
  • cline_mcp_settings.json : réglages des serveurs MCP, pouvant contenir des jetons de services tiers.

La configuration au niveau du projet se trouve généralement dans .cline/ à la racine du dépôt : règles, workflows, hooks, agents, etc. Selon les versions, Cline peut utiliser le stockage de secrets de VS Code ou un répertoire de données unifié ; ne présumez pas que la clé est chiffrée.

Traitez donc ces fichiers comme des fichiers sensibles locaux :

  • Activez le chiffrement du disque et le verrouillage de session, limitez les droits locaux.
  • Ne placez pas ~/.cline sur un cloud public, dans un dépôt de code ou une sauvegarde partagée.
  • Avant commit, vérifiez .vscode/, .cline/, .clinerules et les scripts pour vous assurer qu'aucune clé n'y figure.
  • Les jetons de la configuration MCP se gèrent aussi comme des secrets.
  • Masquez la page de réglages lors des captures d'écran, enregistrements et sessions d'assistance à distance.
  • Avant de synchroniser la configuration, vérifiez le périmètre et le chiffrement de l'outil, puis décidez d'inclure ou non les fichiers de clés.

5. Rotation et révocation

Une rotation tous les 90 jours est recommandée, ou immédiatement après un changement de membre, de machine ou une suspicion de fuite. La rotation se fait en parallèle puis par bascule, pas par suppression-recréation.

  1. Créez une nouvelle clé aux mêmes droits, avec un suffixe de date dans le nom.
  2. Remplacez la clé dans les réglages de Cline ou dans la configuration du fournisseur en CLI.
  3. Envoyez une requête de test et vérifiez que les journaux de la passerelle enregistrent la nouvelle clé.
  4. Observez le taux d'erreur et l'usage pendant un temps, pour détecter un client oublié.
  5. Désactivez l'ancienne clé et conservez-la quelque temps avant suppression.

En cas de fuite suspectée, inversez l'ordre : désactivez ou supprimez d'abord la clé, puis recherchez les usages anormaux, leur origine et leur période, avant de prévenir l'équipe et de vérifier dépôts et journaux. Un départ ou un changement de machine impose une désactivation le jour même, sans attendre le prochain audit.

Avant une rotation, inventoriez les emplacements d'usage : extension VS Code, CLI, CI, autres éditeurs et scripts temporaires. Changer seulement la clé dans l'IDE peut laisser l'ancienne active dans des automatisations.

6. Moindre privilège et stratégie d'équipe

  • Une clé par personne : une clé partagée ne permet pas de distinguer les usages et complique la localisation en cas de fuite. Les services partagés ont leur propre clé.
  • Une clé par usage : développement quotidien, automatisation et tests temporaires séparés, pour faciliter quotas et désactivation.
  • Définir des plafonds : quota, expiration et périmètre de modèles quand c'est possible ; au minimum les deux premiers.
  • Entrée centralisée : privilégier une passerelle commune, avec journaux des membres, des modèles et de l'usage, pour l'audit et l'imputation des coûts.
  • Tenir un registre : ne consigner que le nom de la clé, le détenteur, l'usage, la date de création et l'expiration, jamais la clé complète.
  • Audit régulier : vérifier chaque mois les clés inutilisées, les dépassements et les pics d'échecs d'authentification.
  • Processus d'entrée et de départ : intégrer création, passation et désactivation des clés aux listes d'arrivée et de départ.
  • Classification des données : définir quels dépôts peuvent utiliser quels modèles et canaux ; évaluer les projets sensibles au préalable.
  • Encadrer les droits de l'agent : l'approbation automatique et le mode YOLO amplifient les erreurs et les risques d'injection de prompt ; l'équipe doit fixer les droits par défaut et les exceptions soumises à approbation.
  • Vérifier extensions et MCP : n'installer que depuis des sources fiables ; hooks, plugins et serveurs MCP peuvent exécuter du code ou accéder au réseau.

Le calcul de coût s'appuie sur tarifs des modèles. Ne jugez pas le prix à l'impression d'une tâche isolée : raisonnez en volume de requêtes, longueur de contexte et niveau de modèle.

7. Liste de dépannage

  • 401 ou Invalid API Key : clé erronée, désactivée, ou espace et retour à la ligne au collage. Supprimez et recopiez entièrement.
  • 403 : quota épuisé, droits insuffisants ou modèle hors du périmètre ouvert.
  • 404 ou Model Not Found : chemin de Base URL incorrect ou identifiant de modèle inexistant. Gardez l'adresse jusqu'à /v1, sans /chat/completions.
  • 429 : limitation de débit ou plafond de quota de la clé atteint. Consultez l'usage et les limites dans la console.
  • Délai : point d'accès injoignable, chemin réseau problématique ou proxy bloquant. Vérifiez d'abord la connectivité avec une requête simple.
  • Dépassement de contexte : vérifiez que la Context Window de Cline correspond aux spécifications réelles du modèle et réduisez le périmètre de la tâche.
  • Conversation normale mais actions d'agent en échec : soupçonnez d'abord un modèle sans appels d'outils, pas une clé invalide.
  • CLI normale mais extension en échec : les deux peuvent lire des répertoires de configuration différents ; vérifiez séparément ~/.cline et la configuration du projet.
  • Échec juste après un changement de clé : confirmez l'enregistrement et vérifiez dans les journaux de la passerelle que la nouvelle clé reçoit bien les requêtes.

8. Questions fréquentes

Où est stockée la clé de Cline, et est-elle sûre ?

Dans les versions récentes, ~/.cline/data/settings/providers.json, qui contient la configuration des fournisseurs et les clés API ; les réglages MCP peuvent contenir d'autres jetons. La documentation officielle ne promet pas le chiffrement : protégez le fichier comme une donnée sensible, activez le chiffrement du disque et évitez toute synchronisation vers un emplacement public.

Une clé peut-elle servir à plusieurs modèles ?

Généralement oui, si la passerelle permet à cette clé d'appeler ces modèles. La possibilité de restreindre le périmètre dépend de la console ; sinon, limitez l'impact par le quota et les journaux, et créez une clé séparée pour les modèles coûteux.

Comment partager des modèles dans l'équipe sans exposer la clé ?

N'envoyez pas la même clé à tout le monde. La solution la plus sûre est une clé distincte par personne sur la passerelle, avec une Base URL et une correspondance de modèles communes, et une gestion centralisée des quotas, journaux et désactivations. Les services partagés ont une clé dédiée à quota limité.

La rotation d'une clé affecte-t-elle les tâches en cours ?

Les requêtes déjà envoyées peuvent ne pas être affectées, mais les suivantes utiliseront la nouvelle clé. Basculez aux heures creuses, envoyez immédiatement une requête de test, puis désactivez l'ancienne clé. Pour les tâches longues, vérifiez d'abord si elles peuvent être interrompues.

Que faire en premier après une fuite de clé ?

Désactiver ou supprimer la clé pour limiter les pertes, puis rechercher les usages anormaux et l'origine des appels. Ne cherchez pas d'abord à reconstituer le chemin de la fuite. Vérifiez ensuite dépôts, journaux, conversations et sauvegardes, et faites tourner les autres identifiants si nécessaire.

En résumé

La configuration de la clé Cline est simple ; ce qui est difficile, c'est la gestion dans la durée : un nom traçable, un quota plafonné, un stockage protégé et une capacité à limiter les pertes en cas de fuite. Inscrivez-vous à la passerelle ZSQH AI, créez une clé dédiée à Cline, puis resserrez progressivement les droits selon la politique d'équipe et révisez régulièrement les coûts avec la page tarifs des modèles.

Lecture associée :