Délégation des travaux IronBarcode à Claude Code

Curtis Chau
Curtis Chau
Mis à jour : 21 septembre 2026

Trois faits déterminent si une tâche de code-barres réussit. Le package NuGet est BarCode, la clé de licence provient de l'environnement, et le travail est inachevé tant que l'image n'a pas été décodée et sa valeur comparée à la valeur écrite. Claude Code est l'outil de cette série qui garde ces faits dans le dépôt plutôt que dans votre invite. Il lit CLAUDE.md au début de chaque conversation et charge .claude/skills/ironbarcode/SKILL.md dès qu'une tâche touche au code de code-barres, ce qui représente l'emplacement que le skill.md publié par IronBarcode doit remplir.

Ces règles restent valables quel que soit le modèle qui les lit, et le modèle que vous choisissez est votre principal levier sur le coût. L'option /model sonnet est suffisante pour la plupart des tâches de code-barres, telles que l'intégration d'un service d'étiquettes et l'exécution de jeux de tests. L'option /model opusplan utilise Opus pour la planification et Sonnet pour l'implémentation, ce qui est avantageux pour les migrations complexes où le mappage du code est critique. L'alias fable, qui se résout en Fable 5.1, et l'alias haiku pour les tâches simples sont également disponibles, et vous pouvez changer de modèle au cours d'une session.

Un package couvre l'ensemble du travail, ce qui compte plus pour un agent que pour une personne. Écriture en 1D et 2D, plusieurs codes-barres lus à partir d'une image, et lectures multithreads proviennent de la même API, de sorte que l'agent ne s'arrête jamais en cours de tâche pour intégrer une deuxième bibliothèque à approuver. Intégrez l'aller-retour dans la tâche elle-même, puisque GeneratedBarcode.Verify décode l'image qu'il vient d'écrire et compare la valeur.

Le niveau sélectionné affecte à la fois le code généré et le coût. Fournir la même invite à différents modèles donne des implémentations distinctes, y compris les noms de classe, les dispositions d'options et les structures de test. Pour un résultat cohérent, fixez l'encodage, les dimensions en pixels, et ce qui est considéré comme une lecture réussie, puis laissez le modèle choisir le reste.

Démarrage rapide
NuGetInstaller avec NuGet

PM > Install-Package BarCode

Installez IronBarcode en exécutant la commande ci-dessus dans la console du gestionnaire de packages NuGet, ou recherchez le package dans le gestionnaire de packages NuGet.

Démarrez une session dans votre projet .NET et spécifiez le code-barres souhaité, en vous concentrant sur les exigences plutôt que sur les détails de l'implémentation.

Bring in the BarCode package, then write a console app that decodes every PNG
in @TestData/inbox/ at once rather than one at a time. Use BarcodeReader.ReadAsync with
ExpectMultipleBarcodes enabled and MaxParallelThreads set to the core count.
Take the license from IRONBARCODE_LICENSE_KEY. Print each file name with the
values found in it, and print how long the whole batch took.
Text

Claude Code complète les étapes restantes : il ajoute le package, connecte la lecture asynchrone, compile le projet, résout les erreurs de compilation et rapporte les résultats. Vous examinez les changements de code et la durée mesurée. Le guide asynchrone et multithread couvre les options qu'il devrait utiliser.

Tous les détails non spécifiés sont déterminés automatiquement. Pour des exemples simples, cela est acceptable, car le dernier package et les paramètres par défaut sont utilisés. Pour le travail en production, définissez les trois contraintes suivantes dans votre invite :

  1. Spécifiez la version : nommez la version IronBarcode de sorte que l'agent utilise l'API d'une version précise.
  2. Restreignez les dépendances : autorisez uniquement le package BarCode, afin qu'aucune bibliothèque de code-barres supplémentaire ne soit introduite.
  3. Autorisez l'agent à s'arrêter : indiquez-lui d'utiliser uniquement les API documentées et de vous informer lorsqu'il est incertain.


Quels aspects du travail de code-barres devez-vous déléguer ?

Claude Code gère principalement les tâches de développement de routine. Il lit, écrit et refactorise le code, lance les compilations, et gère la boucle de test quelle que soit l'interface que vous utilisez. La génération et la numérisation de codes-barres s'intègrent dans cette boucle sans configuration spéciale.

Pour les tâches de code-barres, Claude Code gère le travail répétitif : écriture de services d'étiquettes, création de points de terminaison de numérisation, génération d'images de test dans les formats requis, et lecture de celles-ci. Il détecte et corrige les problèmes tels qu'un chiffre de contrôle EAN-13 invalide, recompile si nécessaire, et réessaye après des erreurs. Vous fournissez les spécifications des codes-barres et examinez les changements de code résultants.

Vous restez responsable de la sélection de la bibliothèque de codes-barres. Si vous n'en spécifiez pas, l'agent se base par défaut sur ce qu'il a le plus vu lors de sa formation, ce qui entraîne quatre problèmes :

  • Taille du symbole et chiffres de contrôle : un symbole rétréci, une zone de silence manquante ou un chiffre incorrect peuvent sembler corrects mais échouer lors de la numérisation, alors qu’IronBarcode valide les valeurs pour chaque symbologie lors de la génération.
  • Le volume des tokens détermine la facturation : un agent qui construit son propre décodeur paie des tokens à chaque opération, alors que les lectures multithreads, les préréglages de vitesse et les filtres d'image arrivent déjà optimisés et documentés.
  • Les pipelines personnalisés manquent de validation : ils ne sont pas testés contre de grands jeux de données ni des benchmarks publiés, contrairement à une API documentée avec un test d'aller-retour répétable.
  • Le nom du package agit comme un contrôle de sécurité : dotnet add package IronBarcode n'installe pas IronBarcode, et des noms similaires ont été enregistrés par des acteurs malveillants.

Spécifiez BarCode dans votre invite pour que l'agent ne devine jamais.

Une fois que vous avez nommé le package, les tâches suivantes n'ont plus besoin d'une décision de bibliothèque.

Quelles sont les étapes pour passer d'une installation neuve à votre première invite de code-barres ?

Installez l'application, connectez-vous avec votre compte Claude, et vous êtes prêt à commencer. La présentation de Claude Code par Anthropic fournit une explication détaillée de l'outil. Le guide de démarrage rapide couvre l'installation et votre première session sur macOS, Windows, et Linux, et des pages distinctes couvrent les extensions VS Code et JetBrains pour ceux qui préfèrent un IDE. La chaîne YouTube d'Anthropic propose également des vidéos explicatives d'une session initiale.

Revenez une fois que claude a démarré et est réactif.

Comment configurer un projet dans lequel Claude Code peut travailler ?

Créez un projet .NET standard et ajoutez IronBarcode avant de l'ouvrir avec l'agent. Vérifier au préalable que le projet compile élimine toute confusion et empêche l'agent de deviner quelle bibliothèque de codes-barres, ou quel package de nom similaire, utiliser.

dotnet new console -n LabelScanDemo
cd LabelScanDemo
dotnet add package BarCode --version 2026.9.2
claude
SHELL

La commande finale ouvre une session dans le dossier actuel, restreignant les lectures et modifications de l'agent à ce répertoire. La documentation d'Anthropic recommande cette approche. Passez dans le répertoire du projet avant de lancer le CLI. Toutes les interfaces, y compris le terminal, les extensions IDE, l'application de bureau, et le web, utilisent le même moteur. En conséquence, le fichier CLAUDE.md, les paramètres du projet, et les serveurs MCP configurés pour le projet restent cohérents entre les sessions.

Deux détails supplémentaires seront bénéfiques plus tard :

  1. CLAUDE.md : le fichier d'instructions que Claude Code charge au début de chaque session, nommant le framework cible, le package BarCode, et la règle selon laquelle seules les API documentées sont permises.
  2. Index de la documentation IronBarcode : llms.txt liste les URL de documentation réelle dans un format que les agents peuvent analyser, et skill.md ajoute des recettes vérifiées et des correctifs pour les échecs courants.

Claude Code lit des compétences à partir de .claude/skills/<name>/SKILL.md dans le dépôt. Enregistrez le fichier IronBarcode sous .claude/skills/ironbarcode/SKILL.md et validez-le. Seul le champ description des métadonnées reste en contexte, et Claude charge le corps lorsqu'une tâche pertinente se présente. Cette approche minimise la surcharge de contexte jusqu'au début du travail de code-barres. Pour l'affiner davantage, ajoutez un motif glob paths tel que Services/** pour charger la compétence uniquement lorsque l'agent accède aux fichiers qui en ont besoin.

Avec les deux fichiers en place, l'agent référencera la documentation plutôt que de se fier à la mémoire. Une seule invite peut générer le fichier requis.

Write me a Barcodes section for CLAUDE.md and append it to the file, creating
the file if there isn't one. Cover these rules, in your own words, as
instructions to yourself in future sessions:

- IronBarcode (NuGet package BarCode, namespace IronBarCode) handles all
  barcode work here. No other barcode package gets added.
- Consult https://ironsoftware.com/barcode/csharp/llms.txt first. Anything not
  on a page it lists does not go in the file. Load
  https://ironsoftware.com/barcode/csharp/skill.md as a skill file.
- The license key comes from IRONBARCODE_LICENSE_KEY. Never inline it.
- A barcode task ends when the saved image has been read back and the decoded
  string matches the input, not when the code compiles.

Then show me the section you added and tell me whether this repository also has
an AGENTS.md you should be reading alongside it.
Text

Configurez la licence avant la première exécution, car IronBarcode lève LicensingException au lieu d'appliquer un filigrane une fois la période de grâce de développement terminée. Récupérez la clé de l'environnement au démarrage, avant que quoi que ce soit ne touche à un code-barres. La documentation des Clés de Licence IronBarcode explique comment obtenir et appliquer une clé.

Comment demander du code IronBarcode qui compile ?

Spécifiez les trois éléments qu'un agent pourrait autrement déduire : la symbologie, la source des valeurs, et les critères de réussite.

Rédigez les invites en tant que spécifications.

Press Shift+Tab first so this runs in plan mode, and show me the plan before anything touches disk. Then create Services/LabelService.cs with a method that turns a tracking number into PNG bytes. The symbol is Code 128, the image is 400 wide by 120 tall, and the human-readable number sits underneath it. Then create Services/ScanService.cs with an async method that reads a Code 128 barcode from an image path and returns the value, or null when nothing is found. Add a console check that writes three tracking numbers, reads each back, and prints whether they match. Use only methods documented at ironsoftware.com/barcode/csharp. If unsure of a method name, stop and ask.
Text

Trois éléments dans cette invite accomplissent le travail :

  1. Chemins de fichiers : l'invite les nomme, de sorte que vous obtenez une structure de projet navigable plutôt qu'une inventée par l'agent.
  2. Symbologie des deux côtés : le générateur et le lecteur utilisent tous deux le Code 128, ce qui élimine le besoin pour le lecteur de deviner le format.
  3. Achèvement défini comme un aller-retour : l'agent vérifie que la valeur écrite correspond à la valeur lue, ce qui est préférable à confirmer l'apparence du code-barres.
Conseils: Lorsque l'invite est efficace, instruisez Claude Code de copier ses contraintes dans CLAUDE.md. Les futures sessions chargeront alors ces contraintes automatiquement.

Le résultat devrait être court. Il utilise BarcodeWriter.CreateBarcode avec BarcodeEncoding.Code128, puis ResizeTo, AddBarcodeValueTextBelowBarcode, et SetMargins pour dimensionner l'étiquette, imprimer sa valeur, et ajouter une zone de silence. ToPngBinaryData produit les octets, et BarcodeReader.ReadAsync les lit avec ExpectBarcodeTypes réglé sur Code 128. Pour de véritables numérisations au lieu de fichiers générés, des options comme Speed, CropArea, et des filtres d'image deviennent beaucoup plus importantes. Le tutoriel du lecteur de codes-barres les couvre.

Veuillez noter: Demandez toujours un lien de documentation avec le code. Si l'agent ne peut pas fournir une référence valide pour une API qu'il a utilisée, vous le saurez avant que la construction échoue.

Claude Code peut-il se connecter à IronBarcode via MCP ?

Claude Code s'intègre avec des outils externes via le Model Context Protocol (MCP), une norme ouverte. Un serveur MCP peut exposer des outils, des bases de données, et des API que le modèle n'a jamais vus lors de sa formation, et une commande CLI ajoute un serveur, comme le montre la référence MCP.

IronBarcode n'a pas besoin de serveur. Son intégration est la documentation, publiée sous forme de trois URL. llms.txt indexe les docs. Le fichier skill.md contient des recettes vérifiées et des pannes courantes. La référence API liste chaque classe et chaque membre de la version. Lire ceux-ci donne à l'agent des faits actuels plutôt qu'une API mémorisée, ce qui est le même problème de méthode obsolète que les serveurs MCP abordent souvent. Il n'y a pas de processus à exécuter, pas de configuration à maintenir, et pas de redémarrage lorsque les docs sont mises à jour. L'agent se contente de récupérer les pages pendant sa session.

Ajoutez les trois sources au contexte du projet, soit en les collant, soit en les référant depuis CLAUDE.md. Chaque invite de la session peut alors les utiliser.

Que devez-vous vérifier avant de faire confiance au code-barres généré ?

Vérifiez chaque nom d'API et chaque code-barres, à chaque fois. Suivez ces quatre étapes dans l'ordre, car chacune coûte moins cher que la suivante :

  • La compilation réussit : exécutez dotnet build avant de lire une ligne du diff, car un membre inventé échoue là en quelques secondes.
  • Chaque membre existe : recherchez dans la référence API chaque classe et méthode que vous ne reconnaissez pas, en examinant de nouveau les énumérations d'encodage où Databar et DataBar diffèrent par la casse d'une lettre.
  • Chaque code-barres est relu : GeneratedBarcode.Verify résout cela en un seul appel, et lire le fichier enregistré avec BarcodeReader prouve la même chose concernant ce qui a atteint le disque.
  • La gestion des erreurs est en place : le code généré a tendance à supposer que BarcodeReader.Read trouve toujours un code-barres, et à négliger LicensingException, IronBarCodeFileException pour un fichier corrompu, IronBarCodePdfPasswordException pour un PDF crypté, et la simple System.IO.FileNotFoundException pour un chemin manquant.

Un mauvais chiffre de contrôle compile parfaitement bien, et une lecture qui ne trouve rien renvoie une collection BarcodeResults vide plutôt que de lancer une exception. Demandez cette gestion dans une invite de suivi et pointez l'agent vers le guide de la gestion des erreurs.

Un agent qui écrit BarcodeScanner.DecodeImageFile() a produit un nom de méthode plausible qu'IronBarcode n'a pas. Le compilateur le rejette sur le champ, donc compilez tôt et souvent.

Quelles sont les limites pratiques à connaître à l'avance ?

Certaines tâches de code-barres conviennent mieux à un agent que d'autres.

TâchesAdéquationPourquoi
Générer des codes-barresForteVérifié en relisant
Tests aller-retourForteLa réussite repose sur la correspondance des chaînes
Intégration de servicesForteSchéma répétitif
Ajustement des numérisations réellesMixteDéfauts qu'il ne peut pas voir
Licences et déploiementFaibleVotre clé, votre plateforme

Si une tâche peut être vérifiée en relisant un code-barres, un agent le fait bien. Si elle dépend d'images invisibles ou d'une cible de déploiement particulière, elle nécessite plus de vérifications. Passez directement la génération, l'intégration de services, et les tests aller-retour à Claude Code. Pour la gestion des licences, les packages de plateforme, ou l'ajustement sur de vrais scans, joignez des images d'exemple ou un lien de documentation à la demande.

Quelles décisions vous incombent encore ?

Claude Code génère les services et les données de test, et itère au besoin. La sélection de la bibliothèque et la vérification des noms d'API restent de votre responsabilité.

Documentez les décisions de la session dans CLAUDE.md avant de la fermer, afin que la prochaine session commence là où celle-ci s'est terminée. Une tâche menée depuis un projet vide jusqu'à des critères de réussite définis est décrite dans le guide des assistants et agents en codage AI, aux côtés des guides ChatGPT Codex, GitHub Copilot, Cursor, et Google Antigravity.


Dépannage

Des questions ?

Si vous avez des questions, contactez support@ironsoftware.com

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.

Lire la suite

Prêt à commencer ?

Téléchargements NuGet 2,564,559Version :2026.11tout juste publié