Skip to Content
Développement d'applications IoTDévelopper avec Claude Code

Développer avec Claude Code

Claude Code est l’agent de codage IA d’Anthropic. IronFlock publie pour lui deux plugins dans une seule marketplace :

PluginPourSkills
ironflockLes personnes qui exploitent IronFlock : il connecte Claude à votre instance IronFlock, afin que Claude puisse s’occuper de vos projets, appareils, applications et donnéesironflock-connect, ironflock-fleet, ironflock-data, ironflock-cli
ironflock-devLes personnes qui développent des applications et des widgets pour IronFlock : il apprend à Claude Code comment une application IronFlock est construite et comment elle s’intègre à la plateformeironflock-templates, ironflock-widgets

ironflock-dev a besoin de ironflock, et Claude Code installe ironflock avec lui. Pour exploiter IronFlock sans développer d’applications, installez ironflock seul.

Les plugins sont publics sur GitHub : IronFlock/agent-skills.

Installer les plugins

Ajoutez la marketplace de plugins IronFlock, puis installez-en le plugin de votre choix — soit dans Claude Code, soit depuis un terminal. ironflock-dev inclut ironflock ; installez ironflock@ironflock seul si vous ne développez pas d’applications :

/plugin marketplace add IronFlock/agent-skills /plugin install ironflock-dev@ironflock

Les plugins sont installés pour votre compte utilisateur : Claude Code peut donc les utiliser dans tous vos projets. Ils se chargent dans les nouvelles sessions ; dans une session déjà en cours, entrez /reload-plugins. Pour vérifier l’installation, exécutez claude plugin list — la commande affiche ironflock-dev@ironflock et ironflock@ironflock.

Connecter Claude Code à votre instance

Le plugin ironflock connecte Claude Code à l’endpoint MCP d’IronFlock, dans le cloud ou sur une appliance, avec une clé API. Il fonctionne sans la commande ironflock et sans shell sur vos machines.

  1. Créez une clé API dans Studio, sous Paramètres utilisateur > Développeur > Clés API (Créer une clé API).
  2. Installez le plugin avec /plugin install ironflock@ironflock. L’installation ouvre une boîte de dialogue avec deux paramètres : IronFlock API address et IronFlock API key. Gardez https://api.ironflock.com pour le cloud. Pour une appliance, saisissez https://api. suivi du domaine de l’appliance, sans /mcp et sans barre oblique finale. Claude Code conserve la clé dans le magasin sécurisé d’identifiants du système, et non dans un fichier de paramètres.
  3. Redémarrez Claude Code. /mcp liste alors plugin:ironflock:ironflock comme connecté.
  4. Demandez à Claude de lister vos projets IronFlock et les appareils de l’un d’eux.

Modifiez les paramètres plus tard avec /plugin configure ironflock@ironflock et un redémarrage. Tant que la clé n’est pas définie, le serveur ne démarre pas ; une installation depuis un shell (claude plugin install) n’ouvre pas la boîte de dialogue, terminez-la donc avec /plugin configure ironflock@ironflock dans une session.

Une appliance propose l’endpoint dès qu’elle exécute le service API IronFlock ; en attendant, connectez-vous au cloud. L’application Claude sur le web, sur ordinateur et sur téléphone, ainsi que Cowork, se connectent plutôt avec un connecteur personnalisé : voir Connecter Claude.

Sécurité : Ne collez jamais une clé API dans une conversation. Saisissez-la dans les paramètres du plugin. Ne donnez à la clé que ce dont Claude a besoin : Lecture seule pour consulter une flotte, d’autres autorisations seulement lorsque Claude doit modifier des choses. Voir Protéger votre clé.

Ce que Claude peut faire pour votre flotte

Une fois la connexion en place, les skills du plugin ironflock démarrent d’elles-mêmes lorsque vous posez une question :

SkillCe qu’elle fait
ironflock-connectConnecte Claude à IronFlock, vérifie la connexion avec une première lecture, et explique ce qu’une clé API permet à Claude de faire. Elle aide aussi lorsque les outils IronFlock manquent ou ne parviennent pas à se connecter
ironflock-fleetS’occupe des appareils et des applications : ce qui s’exécute où, quels appareils sont en ligne, pourquoi un appareil ou une application ne fonctionne pas (l’appareil, puis l’état et les données de l’application, puis les journaux et le journal d’audit), les alarmes, les outils propres aux applications, et l’installation, la mise à jour, le démarrage, l’arrêt et la suppression d’applications
ironflock-dataRépond aux questions à partir des données d’un projet : elle lit d’abord les tables du projet, interroge la base de données en SQL en lecture seule, lit les fichiers que stockent les applications, et enregistre des transformations personnalisées pour les boards
ironflock-cliLe travail sur les machines avec la commande ironflock, là où Claude dispose d’un shell : connecter une machine comme nouvel appareil, se connecter, vérifier une machine avec status et doctor, et travailler sur une autre machine avec --host

Claude lit avant de modifier quoi que ce soit, et demande avant chaque modification : installer ou supprimer une application, créer ou supprimer un appareil, modifier une alarme ou une transformation. Exemples :

  • “Quels appareils du projet Packaging sont hors ligne, et que s’exécute-t-il sur les autres ?”
  • “Le collecteur sur press-7 n’envoie pas de données. Trouvez pourquoi.”
  • “Quelle était hier la température moyenne par heure sur la ligne 3 ?”
  • “Qui a arrêté le collecteur la semaine dernière ?”
  • “Enregistrez une transformation qui affiche la disponibilité de chaque machine par équipe.”

ironflock-cli a besoin d’un shell sur votre propre ordinateur ou sur la machine à configurer, elle ne fonctionne donc que dans Claude Code. Un shell sandbox dans l’application Claude n’est pas cette machine. Demandez à Claude de « connecter cette machine comme nouvel appareil dans le projet X ». Il configure l’appareil sur la machine avec ironflock agent install --project <project> --name <name>, qui crée l’appareil et conserve son fichier de configuration sur la machine. Il vérifie la machine et votre connexion, vous dit ce qu’il s’apprête à faire et attend votre accord avant d’installer quoi que ce soit. Vous vous connectez avec une clé API enregistrée dans un fichier que vous seul pouvez lire : la clé n’est jamais saisie dans la conversation ni sur une ligne de commande. Les commandes qu’il utilise sont décrites dans Connexion et gestion des appareils.

Les outils qui travaillent dans un projet ont besoin de la clé du projet, que Claude trouve avec la première lecture. Ce qu’une clé permet à Claude de faire est défini par ses autorisations, et chaque outil est listé avec son autorisation sur la page Endpoint MCP.

Développer des applications avec le plugin ironflock-dev

IronFlock publie la skill ironflock-templates dans le plugin ironflock-dev. Elle apprend à l’agent comment une application IronFlock est construite et comment elle s’intègre à la plateforme. Grâce à elle, Claude Code crée de nouvelles applications conformes à l’architecture de référence, écrit les fichiers du répertoire .ironflock/ de votre application sous la forme attendue par la plateforme, et les vérifie avant la publication d’une version :

FichierCe que l’agent peut faire
board-template.ymlCréer le board de l’application : choisir les widgets, les lier à vos tables, organiser les pages et la navigation
data-template.ymlDéfinir les tables et les transformations qui correspondent à ce que publie votre code
env-template.ymlAjouter des paramètres d’application
port-template.ymlDéclarer les ports pour l’accès à distance
ai-template.ymlDéfinir les agents IA de l’application et leurs outils

Le plugin contient aussi ironflock-widgets, qui crée et modifie les widgets de board eux-mêmes, les composants web @ironflock/widget-*, dans un checkout d’un dépôt de widget.

Contenu de la skill

  • L’architecture de référence : comment les parties d’une application fonctionnent ensemble, des tables qui contiennent son état jusqu’aux interfaces web que servent les appareils.
  • Une application de démarrage qui la suit, à partir de laquelle Claude Code crée une nouvelle application : un programme qui interroge une machine sur chaque appareil, conserve l’état et les mesures de chaque appareil dans des tables, applique un seuil que les utilisateurs définissent sur le board, et sert une vue en direct que le board intègre.
  • Les schémas JSON des cinq templates — les mêmes que ceux publiés sur https://ironflock.com/schemas/.
  • Un guide du template de board : liaisons de données, filtres, agrégation, pages, navigation et mise en page.
  • Un catalogue de tous les widgets de board, qui précise à quelles données chaque widget est destiné.
  • Un outil qui lit le schéma de configuration d’un widget pour la version exacte de ce widget utilisée par un board.
  • Un validateur qui vérifie chaque template par rapport à son schéma et aux règles que la plateforme ne signale sinon qu’au moment de l’installation — par exemple un widget lié à une colonne qui n’existe pas.

Prérequis

  • Claude Code — voir le guide d’installation d’Anthropic.
  • Python 3.9 ou version ultérieure pour le validateur. uv est recommandé : avec uv, le validateur installe lui-même ses dépendances. Sans uv, exécutez une fois python3 -m pip install pyyaml jsonschema.
  • Accès Internet à registry.npmjs.org et cdn.jsdelivr.net, où sont publiés les schémas des widgets.

Utiliser la skill

Vous n’avez pas besoin d’appeler la skill. Claude Code l’utilise de lui-même lorsque vous travaillez sur une application IronFlock — par exemple lorsque vous demandez :

  • “Ajoutez à cette application un board qui affiche, pour chaque machine, la température actuelle sous forme de jauge et sa tendance sur 24 heures.”
  • “Rendez l’intervalle d’échantillonnage configurable par appareil, entre 1 et 60 secondes.”
  • “Rendez l’interface web du port 8080 accessible à distance.”
  • “Créez une nouvelle application qui lit le niveau de remplissage du réservoir sur chaque PC industriel, avec un seuil d’alarme de niveau bas que les opérateurs définissent à un seul endroit pour tous les réservoirs.”

Pour lancer explicitement une skill, entrez /ironflock-dev:ironflock-templates, ou /ironflock:ironflock-fleet et ainsi de suite pour les skills du plugin ironflock.

Claude Code lit d’abord le code de votre application, afin que les tables correspondent à ce que publie le code. Il écrit ensuite les templates et exécute le validateur jusqu’à ce qu’il ne reste plus aucune erreur. Vous pouvez alors ouvrir le board dans l’UI Builder pour l’ajuster visuellement — l’UI Builder lit et écrit le même fichier board-template.yml.

La skill ne modifie que les fichiers du dépôt de votre application. Publiez une nouvelle version de votre application pour que les modifications parviennent aux projets qui l’utilisent — voir Versions et l’App Store.

Valider les templates sans l’agent

Le validateur fonctionne aussi de manière autonome, par exemple dans un pipeline CI :

git clone https://github.com/IronFlock/agent-skills uv run agent-skills/plugins/ironflock-dev/skills/ironflock-templates/scripts/validate.py path/to/your-app

Il affiche une ligne par problème détecté, avec le fichier, la ligne et le chemin, et se termine avec le code de sortie 1 s’il a trouvé une erreur.

Maintenir les plugins à jour

Claude Code ne met à jour les plugins des marketplaces tierces que si vous activez la mise à jour automatique. Il suffit de l’activer une fois : exécutez /plugin dans Claude Code, ouvrez Marketplaces, sélectionnez ironflock et choisissez Enable auto-update. Ou mettez à jour manuellement :

claude plugin marketplace update ironflock claude plugin update ironflock-dev@ironflock claude plugin update ironflock@ironflock

Si vous utilisiez déjà le plugin

Auparavant, il n’y avait qu’un plugin, ironflock, avec les deux skills de développement. Elles ont été déplacées vers ironflock-dev. Après la mise à jour, ironflock@ironflock contient les skills d’exploitation et une courte skill qui renvoie vers ironflock-dev. Ajoutez une ligne pour conserver les skills de développement :

claude plugin install ironflock-dev@ironflock

Ou ajoutez "ironflock-dev@ironflock": true à enabledPlugins, à côté de "ironflock@ironflock": true. Les skills de développement se lancent désormais avec /ironflock-dev:ironflock-templates et /ironflock-dev:ironflock-widgets.

Configurer les plugins pour votre équipe

Pour mettre les plugins à la disposition de toutes les personnes qui travaillent sur une application, commitez ce fichier dans le dépôt de l’application sous le nom .claude/settings.json :

{ "extraKnownMarketplaces": { "ironflock": { "source": { "source": "github", "repo": "IronFlock/agent-skills" }, "autoUpdate": true } }, "enabledPlugins": { "ironflock@ironflock": true, "ironflock-dev@ironflock": true } }

Claude Code applique le fichier dès qu’un membre de l’équipe fait confiance au dossier. Chaque personne saisit sa propre clé API dans les paramètres du plugin. La clé ne fait jamais partie de ce fichier.

Désinstaller

claude plugin uninstall ironflock-dev@ironflock claude plugin uninstall ironflock@ironflock claude plugin marketplace remove ironflock
Last updated on