Cline

Cline est un agent de programmation dans l’IDE. Il peut lire les fichiers du projet, exécuter des commandes et modifier du code après autorisation. Configurez un OpenAI Compatible Provider pour utiliser l’endpoint Chat Completions compatible d’AGTCloud.

Ce tutoriel couvre l’extension IDE Cline. Le support des outils, images, Computer Use et longueurs de contexte varie selon le modèle. Choisissez un modèle accessible à l’API Key et prenant en charge Chat Completions ainsi que les appels d’outils.

Prérequis

Avant de commencer, vérifiez que vous avez :

Installé un éditeur compatible VS Code ou un IDE JetBrains pris en charge ;
Créé un compte AGTCloud et ouvert une session ;
Créé un Token dans API Keys ;
Copié dans le catalogue de modèles un ID accessible au Token et compatible Chat Completions ;
Préparé un projet de test sans code sensible.

Installer Cline

Choisissez la méthode correspondant à votre IDE. Cline propose aussi une CLI, un SDK et Kanban, non couverts ici.

Pour VS Code, Cursor, Windsurf, VSCodium et les éditeurs similaires :

Ouvrez le marché des extensions ou utilisez Ctrl/Cmd + Shift + X ;
Recherchez Cline ;
Sélectionnez l’extension officielle et cliquez sur Installer ;
Cliquez sur l’icône Cline dans la barre d’activité ou lancez Cline: Open In New Tab depuis la palette.

Windsurf et VSCodium utilisent Open VSX, avec une procédure similaire.

Si une autorisation ou une initialisation Cline est demandée au premier démarrage, suivez l’interface actuelle. Consultez la documentation officielle d’installation pour les autres méthodes.

Configurer AGTCloud

Ouvrir API Configuration

Ouvrez le panneau Cline, cliquez sur les paramètres et accédez à API Configuration. L’emplacement varie légèrement selon l’IDE et la version.

Choisir le Provider compatible

Dans API Provider, sélectionnez OpenAI Compatible, pas le Provider intégré OpenAI.

Renseigner la connexion

Champ Cline	Valeur
`API Provider`	`OpenAI Compatible`
`Base URL`	`https://api.agtcloud.cn/v1`
`OpenAI Compatible API Key`	`your-api-key`
`Model ID` ou `Model`	`MODEL_ID`
`Custom Headers`	Laisser vide par défaut

Remplacez your-api-key et MODEL_ID par votre Token et votre ID de modèle.

Vérifier et enregistrer

Si votre version propose Verify, vérifiez d’abord la connexion. Après validation, cliquez sur Done ou le bouton d’enregistrement actuel.

La Base URL doit contenir /v1

Le Provider OpenAI Compatible de Cline exige la Base URL API complète. Utilisez https://api.agtcloud.cn/v1, pas seulement l’API Origin, et n’ajoutez pas un second /v1 créant /v1/v1.

Choisir et configurer le modèle

MODEL_ID est une valeur fictive à remplacer. Copiez dans le catalogue de modèles un ID accessible à l’API Key et prenant en charge Chat Completions et les appels d’outils.

Model Configuration peut proposer Context Window, Max Output Tokens, Image Support, Computer Use, Input Price et Output Price. Conservez les valeurs par défaut pour la première connexion ; adaptez-les uniquement si vous connaissez les limites et capacités réelles du modèle.

Les paramètres avancés ne créent pas de capacités

Cocher les images ou Computer Use dans Cline ne donne pas ces capacités à un modèle qui en est dépourvu. Les prix servent surtout à l’estimation locale de consommation, pas à la facturation finale AGTCloud.

Démarrer et valider la connexion

Ouvrir un projet de test

Utilisez un projet sans code sensible avec un README.md lisible en toute sécurité.

Laisser l’approbation automatique désactivée

N’activez pas Auto Approve lors de la première validation. Examinez chaque lecture, commande ou modification prévue avant de l’autoriser.

Demander une tâche en lecture seule

Saisissez dans Cline :

Veuillez lire README.md et résumer l’objectif du projet en trois points. Ne modifiez aucun fichier.

Vérifier le résultat

La lecture du fichier et un résumé normal, sans modification non autorisée, confirment la connexion de base. Cette étape entraîne une consommation API normale.

Questions fréquentes

Symptôme	Vérifier en priorité	Solution
Extension Cline absente	Origine, compatibilité IDE et redémarrage	Vérifiez l’extension officielle, puis rechargez ou redémarrez l’IDE
Échec de `Verify`	Réseau et Base URL	Vérifiez l’accès local à AGTCloud et utilisez `https://api.agtcloud.cn/v1` complet
Réponse `401`	API Key et état du Token	Copiez une clé valide, sans espaces superflus
Réponse `403`	Autorisations du Token et du modèle, état du compte	Vérifiez le Token et les modèles accessibles dans la console
Réponse `404`	Base URL, doublon `/v1` et ID du modèle	Évitez `/v1/v1` et recopiez l’ID complet
Message Model Not Found	Modèles accessibles et protocole	Choisissez un modèle accessible à l’API Key et compatible Chat Completions
La conversation fonctionne, mais pas les outils	Appels d’outils et configuration avancée	Choisissez un modèle avec outils et vérifiez les limites de contexte et de sortie
Échec des images ou de Computer Use	Capacités réelles du modèle	Ne vous fiez pas uniquement aux options Cline ; vérifiez le support effectif
Résultat anormal ou interruption	Proxy, paramètres et limites de contexte	Rétablissez d’abord les paramètres avancés par défaut, puis vérifiez le proxy, le pare-feu et le contexte

En cas de problème non identifié, consignez l’heure, l’ID du modèle, le code HTTP et l’erreur expurgée, puis consultez Erreurs et dépannage. Ne fournissez pas d’API Key complète.

Conseils de sécurité

N’inscrivez pas l’API Key dans les fichiers du projet, Git, les captures d’écran, journaux ou configurations partagées ;
Ne validez pas pour la première fois dans un projet contenant des identifiants de production, des données privées ou des sources non publiques ;
Laissez Auto Approve désactivé et confirmez chaque opération avant exécution ;
Sur un appareil partagé, effacez l’API Key enregistrée dans Cline après utilisation.