Outils en ligne de commande et agents
Choisissez les outils de développement AGTCloud selon vos besoins, le protocole et les autorisations.
AGTCloud peut être utilisé avec des agents en ligne de commande, des extensions IDE, des clients de bureau et des outils de gestion de configuration. Commencez par vérifier le mode de travail et le protocole, puis évaluez les fichiers, les commandes et les services externes auxquels l’outil peut accéder.
Cette page vous aide à choisir rapidement un tutoriel, sans répéter les étapes d’installation et de configuration de chaque outil. Dans le tutoriel choisi, respectez les exigences concernant la Base URL, l’authentification et le modèle.
Les agents peuvent effectuer des opérations locales
Certains outils peuvent lire et modifier des fichiers, exécuter des commandes Shell ou accéder au réseau. Pour une première intégration, utilisez un répertoire de test sans données sensibles, désactivez l’approbation automatique et commencez par des tâches en lecture seule.
Choisir selon l’outil
| Outil | Mode d’utilisation | Protocole d’intégration AGTCloud | Cas d’utilisation privilégié |
|---|---|---|---|
| Claude Code | Agent de programmation dans le terminal | Anthropic Messages | Vous utilisez déjà le workflow Claude Code et souhaitez conserver la structure Messages et Content Blocks |
| Codex | CLI et application de bureau | OpenAI Responses | Vous utilisez Responses, Typed Items ou les workflows de projet Codex |
| Gemini CLI | Agent dans le terminal | Gemini Generate Content | Vous utilisez déjà la structure Gemini Contents et Parts |
| Cline | Extension IDE | OpenAI Chat Completions | Vous souhaitez examiner les actions de l’agent dans un éditeur compatible VS Code ou dans JetBrains |
| Cherry Studio | Client de conversation de bureau | OpenAI Chat Completions | Vous recherchez une interface graphique pour discuter avec plusieurs modèles et vérifier la connexion de base |
| OpenClaw | Gateway auto-hébergé, TUI et Control UI | OpenAI Chat Completions | Vous avez besoin d’un Gateway local et d’un environnement extensible pour exécuter un agent personnel |
| CC-Switch | Gestionnaire de configuration local | Anthropic Messages, OpenAI Responses | Vous devez enregistrer et basculer entre des configurations Provider pour Claude Code et Codex |
| Hermes Agent | Agent dans le terminal | OpenAI Chat Completions | Vous avez besoin d’un Custom Endpoint, de sessions de terminal et d’un workflow d’appel d’outils |
Le nom du protocole ne désigne pas le fournisseur du modèle. Un même modèle peut proposer plusieurs protocoles, mais les appels d’outils, le multimodal, le raisonnement et le contexte restent limités à ses capacités effectives.
Choisir selon la tâche
| Objectif | Tutoriels à consulter en priorité | Motif |
|---|---|---|
| Analyser et modifier du code dans le terminal | Claude Code, Codex, Gemini CLI | Les trois proposent un workflow complet dans le terminal, avec des structures de protocole différentes |
| Examiner progressivement les opérations sur les fichiers et les commandes dans l’IDE | Cline | Le plan d’action, les modifications des fichiers et les autorisations sont regroupés dans l’éditeur |
| Dialoguer avec un modèle dans une interface graphique | Cherry Studio | Après avoir configuré le fournisseur et le modèle, vous pouvez vérifier la connexion depuis l’interface de conversation |
| Exécuter un agent local et auto-hébergé | OpenClaw, Hermes Agent | Ils proposent un Gateway ou un agent CLI et nécessitent un contrôle plus strict des autorisations de l’hôte |
| Gérer plusieurs configurations Claude Code ou Codex | CC-Switch | Il enregistre et sélectionne les Provider en local, sans remplacer le client qui envoie réellement les requêtes |
| Connecter des outils et des sources de données externes | Intégration MCP et sécurité | MCP relie un client à des services d’outils ; ce n’est pas une API de modèle |
Vérifications avant l’intégration
1. Confirmer le mode d’utilisation
Déterminez si vous avez besoin d’un terminal, d’un IDE, d’un client de conversation de bureau ou d’un Gateway auto-hébergé. Ne choisissez pas uniquement d’après le nom de l’outil : vérifiez d’abord sa compatibilité avec les procédures d’approbation et de gestion des autorisations de votre équipe.
2. Confirmer le protocole
Copiez dans le catalogue de modèles un ID accessible à votre API Key et vérifiez que le modèle prend en charge le protocole requis par le tutoriel : Chat Completions, Responses, Anthropic Messages ou Gemini Generate Content.
3. Préparer des identifiants distincts
Créez dans API Keys une API Key facile à identifier et à désactiver. N’inscrivez pas de véritable clé dans un dépôt, une capture d’écran, un journal ou une configuration partagée.
4. Lire les indications sur les autorisations
Vérifiez les répertoires, les commandes, le réseau et les services externes accessibles à l’outil. Désactivez l’approbation automatique par défaut et limitez l’accès au strict nécessaire pour la tâche en cours.
Validation par étapes
| Étape | Tâche recommandée | Critère de réussite |
|---|---|---|
| Connexion de base | Demander uniquement un texte fixe, sans appel d’outils | Une réponse est reçue et le Provider, la Base URL et le modèle correspondent aux attentes |
| Fichiers en lecture seule | Lire et résumer le README.md du répertoire de test | Aucun fichier n’est modifié et aucune commande non approuvée n’est exécutée |
| Outil contrôlé | Effectuer une opération réversible dont la portée est clairement définie | Le client présente l’opération, obtient une confirmation et produit le résultat attendu |
| Tâche de projet | Travailler sur un projet réel sous contrôle de version | Les modifications peuvent être examinées et annulées, et passent les vérifications existantes du projet |
Le démarrage du client ne suffit pas à valider l’intégration. Confirmez au minimum que les requêtes utilisent le Provider, le modèle et le protocole prévus, et que l’outil ne dépasse pas les autorisations accordées.
Questions fréquentes sur le choix des outils
| Question | Recommandation |
|---|---|
| L’outil peut dialoguer, mais pas appeler d’outils | Vérifiez d’abord le support des appels d’outils par le modèle et le protocole, puis la version du client et ses autorisations |
| Un même modèle se comporte différemment selon l’outil | Comparez le protocole, le prompt système, les Schema d’outils, le contexte et les paramètres par défaut du client |
| La configuration est correcte, mais les requêtes utilisent un autre Provider | Redémarrez complètement le client et vérifiez la configuration utilisateur, les variables d’environnement et le Provider actif |
La Base URL renvoie 404 | Vérifiez dans le tutoriel s’il faut saisir l’API Origin, la Base URL avec /v1 ou laisser le client ajouter le chemin |
| Vous hésitez à activer l’approbation automatique | Laissez-la désactivée ; accordez les autorisations une à une seulement lorsque la tâche, les répertoires et les commandes sont clairement délimités |
| Vous devez connecter une base de données, un système de fichiers ou un service métier | Lisez d’abord Intégration MCP et sécurité, puis vérifiez l’origine du service et ses autorisations |
Conseils de sécurité
- Téléchargez les installateurs ou les commandes depuis les canaux officiels de l’outil et lisez les notes de version avant une mise à niveau ;
- Utilisez des API Key distinctes pour pouvoir désactiver et auditer chaque outil indépendamment ;
- Exécutez les tâches qui modifient des fichiers avec la protection d’un contrôle de version ou d’une sauvegarde ;
- Ne transmettez pas au modèle de mots de passe, de données clients, de données de production ou d’autres informations sensibles inutiles ;
- Vérifiez si les journaux, les exports de session et les rapports de plantage contiennent des clés, des chemins ou des données métier ;
- Lorsque vous cessez d’utiliser un outil, supprimez les identifiants qu’il conserve et révoquez les autorisations devenues inutiles.
Si vous avez choisi votre outil, commencez par le tutoriel d’intégration CC-Switch ou consultez directement l’outil correspondant dans le tableau ci-dessus. La Référence API fait référence pour les champs et la structure des réponses.