Comment utiliser IronQR avec Claude Code
L'équipe marketing exige que chaque QR code de campagne utilise la couleur marine de la marque, présente le logo au centre et soit disponible en formats affiche et autocollant. Cependant, chaque choix de style supplémentaire peut réduire la fiabilité de la numérisation. Par exemple, un logo peut obstruer des modules, un premier plan clair peut réduire le contraste, et des tailles d'impression plus petites réduisent la densité de pixels. Un QR code peut sembler correct à l'écran mais échouer en utilisation réelle. Claude Code, l'agent de codage d'Anthropic, fonctionne sur les terminaux, VS Code, JetBrains, applications de bureau et le web. Dans n'importe quel environnement, il lit le projet, édite des fichiers et exécute des commandes, de sorte qu'il peut rendre des codes stylés, décoder des fichiers enregistrés et ajuster le style jusqu'à ce que la charge utile soit préservée.
IronQR génère et lit les QR codes dans le même processus .NET, donc l'agent peut numériser après chaque changement. La bibliothèque rejette automatiquement certains designs illisibles. Un logo dimensionné manuellement qui couvre trop, ou une couleur de premier plan trop proche d'un fond blanc, déclenche une IronQrException lors de la sauvegarde. D'autres choix de style peuvent être enregistrés avec succès mais échouer à être déchiffrés plus tard. L'approche la plus fiable est de tester une matrice de variantes stylées et de décoder chaque PNG enregistré. Ce guide explique comment configurer Claude Code pour ce processus, avec trois invites testées et le comportement d'IronQR sur lequel chacune dépend.
Un seul paramètre de modèle prend en charge les trois invites. L'alias opusplan utilise Opus en mode plan et Sonnet autrement, ce qui convient à une session où seul le développement de la matrice nécessite une planification.
Ouvrez le dossier du projet dans un terminal, démarrez Claude Code et exécutez /model opusplan. Tapez @ avant un chemin de fichier pour remettre à Claude Code ce fichier, puis envoyez la requête.
Install IronQR from NuGet here and make one branded QR code for the
spring-sale campaign in @Brand/campaigns.json. Use that entry's URL,
foreground color, and background color, put @Brand/logo.png in the center,
and save the result as out/spring-sale.png. Print the saved image's width
and height in pixels first, then open the file again with QrReader and print
the decoded text and whether it equals the campaign URL. The license key is
in the IRONQR_LICENSE_KEY environment variable.
La version la plus directe de ce code peut échouer. Dans nos sondes, le code de la vente de printemps au niveau de correction d'erreur par défaut avec un logo dimensionné automatiquement a été enregistré sans erreur, puis lu vide ou a déclenché ObjectDisposedException dans le mode de numérisation par défaut du lecteur. Un logo manuel de 100 pixels sur un code de 500 pixels a été lu correctement.
Vérifiez d'abord la largeur imprimée. Dans notre sonde, les options de style sans taille définie ont produit une image de 49 pixels pour cette URL.
Flux de travail minimal (5 étapes)
- Télécharger la bibliothèque de code QR C# depuis NuGet
- Démarrez Claude Code dans le dossier du projet et choisissez un modèle avec
/model - Enregistrez les règles de style d'IronQR dans
CLAUDE.mdpour que chaque session commence avec elles - Décrivez chaque variante à rendre, du niveau de correction à la taille du logo en passant par les couleurs et la taille des pixels
- Décodez chaque PNG enregistré dans les deux modes de numérisation
Que fait Claude Code dans un projet de QR code .NET?
L'agent écrit le rendu, lit le fichier de la marque, enregistre un PNG par variante, décode chaque fichier et indique quels designs tiennent le coup. Vous dites quelles variantes la campagne nécessite et examinez le tableau qui revient.
Les codes de marque rendent cette vérification digne d'automatisation, car la taille du logo, le niveau de correction et la taille des pixels interagissent. Dans l'exécution testée, IronQR a enregistré un logo manuel à 30 % de la largeur sur un code de 600 pixels et a refusé la même proportion à 120 pixels pour une campagne, et une autre campagne a montré le contraire.
Nommez IronQR comme la seule bibliothèque QR dès la première invite. Un agent qui devine un nom de package peut installer un sosie publié pour attraper cette devinette, une attaque appelée slopsquatting.
Comment configurer Claude Code ?
Installez Claude Code avec le guide rapide d'Anthropic et connectez-vous. Lorsqu'il commence dans un terminal et répond, il est prêt.
Comment configurer un projet dans lequel Claude Code peut travailler ?
Préparez le référentiel avant la première invite. Un projet console .NET 9 qui se construit, un fichier Brand/campaigns.json avec l'URL et les couleurs de chaque campagne, et les fichiers de logo donnent à l'agent de véritables entrées sur lesquelles travailler. Démarrez Claude Code depuis ce dossier pour que la session y soit limitée.
Claude Code lit CLAUDE.md au début de chaque session, ce qui en fait l'endroit idéal pour les règles qui devraient survivre à une invite. Une fois que le Quickstart a ajouté le package, une deuxième invite crée le fichier.
Write CLAUDE.md in the repository root with a section called QR codes. It
should tell every later session that IronQR (NuGet package IronQR, pinned to
the version now in BrandQr.csproj, namespaces IronQr and IronQr.Enum) is the
only QR library allowed here; that IronQR member names are checked against
IronQr.xml inside the ironqr.slim folder of the local NuGet cache before use;
that QrStyleOptions is always given an explicit Dimensions and Margins; that
the key comes only from IRONQR_LICENSE_KEY at startup and is never written to
a file or printed; and that a QR image counts as finished only after the saved
PNG has been decoded back to its exact payload.
Le chemin XML compte parce que les types de style et de lecture sont inclus dans le package IronQR.Slim, sur lequel IronQR dépend, donc la liste des membres se trouve dans ce dossier du cache. Pour des guides au-delà de la liste des membres, IronQR publie un index pour les agents sur llms.txt.
Gérez la licence avant le premier rendu. Sans clé, QrWriter.Write et QrReader.Read déclenchent une LicensingException dont le message est "Licence Production Requise", et il n'y a pas de sortie d'essai filigranée sur laquelle se rabattre. Ce type d'exception n'est pas public, donc faites vérifier à l'application License.IsLicensed après avoir défini la clé à partir de IRONQR_LICENSE_KEY au lieu d'attraper l'exception par nom. La page Clés de licence IronQR couvre l'obtention d'une clé et les endroits où IronQR la lit.
Quels paramètres IronQR appartiennent à CLAUDE.md?
Chaque ligne a été vérifiée par rapport à IronQR 2026.10.1 en construisant une sonde ou en exécutant une avec une clé licenciée. Collez le bloc sous la section des QR codes.
## QR codes: IronQR 2026.10.1 behavior
- new QrStyleOptions { ... } starts at Dimensions 0 and margins 0, which
renders one pixel per module. The constructor with arguments defaults to
300 and 10. Always set both.
- Margins are added outside Dimensions. Dimensions 600 with Margins 24
saves a 648 x 648 PNG. Margins has no getter, so read MarginTop and the
other sides.
- QrErrorCorrectionLevel.High is level Q (about 25 percent) and Highest is
level H (about 30 percent). QrWriter.Write without options uses Highest.
- Build QrOptions with its constructor. An object initializer leaves
Encoding at None, and Write throws IronQrEncodingException.
- QrLogo width and height 0 let IronQR choose the logo size. A manual size
it cannot read back throws IronQrException from Save.
- Save checks a changed foreground color. It does not check a changed
background color.
- qr.Verify(expected) takes the expected text, not a file path.
- Save(style) keeps the style on the QrCode, so a later Save() repeats it.
- Do not put QrImageInput in a using block. Its explicit IDisposable.Dispose
throws NotImplementedException after a successful read. Its public
Dispose() works.
- Read every saved PNG with QrScanMode.Auto and QrScanMode.OnlyBasicScan.
Des modules noirs sur un fond noir ont été enregistrés sans exception, et aucun mode de numérisation n'a pu décoder le fichier.
Comment contrôlez-vous la taille, les marges et les couleurs d'un QR code?
Un objet QrStyleOptions contient tous les choix visuels. Save l'applique et retourne un bitmap que vous écrivez sur le disque avec SaveAs. Le niveau de correction d'erreur est le seul paramètre qui vit ailleurs, dans QrOptions, car il modifie le symbole codé lui-même.
Dimensions définit la taille du code en pixels et Margins la zone calme sur les quatre côtés, tandis que MarginTop et les autres côtés définissent un côté chacun. Color peint les modules sombres et BackgroundColor la zone claire et les marges. Logo prend un QrLogo avec le bitmap, largeur, hauteur et rayon du coin.
Dans notre sonde, un code de 400 pixels avec des marges supérieure et inférieure de 50 pixels et des marges latérales de 20 pixels a été enregistré à 440 x 500. Le guide de redimensionnement, le guide des marges et le guide des couleurs montrent chaque paramètre séparément.
Save sans argument sur un code qui n'a jamais été stylé retourne une image de 250 x 250. Cette taille est une valeur par défaut interne.Quelle taille peut avoir un logo à chaque niveau de correction d'erreur?
Plus petite que les pourcentages de correction ne le suggèrent. Ces chiffres comptent les mots-codes que le décodage Reed-Solomon peut reconstruire, et un logo central n'est qu'une source de dommages. Nous avons rendu l'URL de la vente de printemps à 600 pixels avec un logo carré simple, laissé IronQR le dimensionner automatiquement, puis augmenté la taille manuelle d'un pour cent à la fois jusqu'à ce qu'IronQR refuse de l'enregistrer.
| Niveau | Récupération documentée | Logo automatique (largeur, surface) | Plus grand logo manuel (largeur, surface) |
|---|---|---|---|
| Faible | 7% | 20%, 4,0% | 23%, 5,3% |
| Moyen | 15% | 30%, 9,0% | 31%, 9,6% |
| Haut | 25% | 32,5%, 10,6% | 39%, 15,2% |
| Le plus haut | 30% | 32%, 10,2% | 44%, 19,4% |
Dans l'assemblage 2026.10.1, le dimensionnement automatique essaie une liste courte de fractions de la largeur du code, de moitié à un vingtième, et retient la première que son lecteur décode. Cette liste explique pourquoi High et Highest se situent près d'un tiers de la largeur. Une taille manuelle va plus haut, entre environ 60 et 75% de la récupération documentée par surface, mais IronQR la vérifie avec son propre lecteur en pleine résolution. Un deuxième mode de numérisation peut encore échouer là où cette vérification a réussi.
Les chiffres dépendent de la charge utile. Une URL plus longue produit un symbole plus dense avec des limites différentes, donc considérez le tableau comme la forme du compromis et laissez la matrice mesurer vos propres campagnes.
Comment testez-vous chaque variante stylée IronQR en une seule invite?
Demandez la grille entière en une seule invite et laissez le mode plan d'abord régler le design. Appuyez sur Shift+Tab jusqu'à ce que la barre d'état affiche le mode plan, puis envoyez l'invite.
Build Services/BrandedQrRenderer.cs, which renders one campaign from
@Brand/campaigns.json for a given QrErrorCorrectionLevel, logo mode, and
pixel size, and Services/ScanMatrix.cs, which renders every campaign at every
correction level (Low, Medium, High, Highest), with three logo modes (no
logo, a QrLogo of width and height 0 so IronQR sizes it, and a manual logo 30
percent of Dimensions wide that keeps the logo's aspect ratio), at the poster
and sticker sizes in the JSON. Call the matrix from Program.cs after the
spring-sale code. Save each PNG under out/matrix/. Decode every saved file
twice with a new QrReader each time, once with QrScanMode.Auto and once with
QrScanMode.OnlyBasicScan, and catch exceptions per file, including any that
Save throws. Write out/scan-matrix.csv with campaign, level, logo mode, size,
image width and height, the save result, and both read results, then print
how many variants decode to the exact URL in both modes. When the matrix has
run, have the general-purpose subagent check every IronQR member in the new
files against IronQr.xml and list any it cannot find.
Chaque clause ferme une possibilité que les résultats paraissent meilleurs qu'ils ne le sont.
- Chaque combinaison est nommée : trois campagnes, quatre niveaux, trois modes de logo et deux tailles font 72 variantes, donc une ligne manquante dans
out/scan-matrix.csvest visible. - Les échecs de sauvegarde sont des lignes : un refus de sauvegarde est un résultat, et ces lignes montrent où se situe la limite de taille du logo.
- Un nouveau lecteur pour chaque lecture : une lecture échouée ne peut pas affecter la suivante.
- Un deuxième agent vérifie l'API : le sous-agent à usage général charge
CLAUDE.md, que les sous-agents Explore et Plan intégrés ignorent, donc la vérification voit les règles du projet.
Que devez-vous vérifier avant de faire confiance au code IronQR généré?
QrScanMode.Auto revient au scan de base uniquement lorsque son modèle de détection ne trouve rien, et la propre documentation de l'énum l'explique comme le modèle de détection d'abord, puis "une lecture de force brute de base si aucun n'est trouvé". Lorsque le modèle trouve le code mais ne peut pas le décoder, Auto renvoie un résultat vide et le scan de base n'est jamais exécuté.
Le scan de base a décodé chaque variante Quickstart qui a échoué ci-dessus, et l'exception provient de l'intérieur d'IronQR 2026.10.1. Dans notre exécution de calibration de la matrice complète, chaque fichier qu'Auto a manqué avait un logo, et six des huit étaient à High ou Highest, les deux niveaux avec le plus de redondance à dépenser pour un logo. Dans l'exécution testée, avec une marge plate de 10 pixels choisie par l'agent, deux des huit pertes d'Auto n'avaient pas de logo du tout.
Ajoutez ces vérifications au même examen.
- La construction : un membre inventé échoue
dotnet build, tout comme une directive using orthographiéeIronQR, qui utilise la casse du package tandis que l'espace de noms estIronQr. - Les tailles : comparez chaque largeur enregistrée avec la taille demandée plus les marges latérales. Un décalage montre un style qui n'a jamais atteint l'appel d'enregistrement.
- La charge utile : décodez le fichier sur le disque.
Verifycompare le texte avec le rendu en mémoire propre à IronQR, donc un chemin de fichier renvoie faux et un fichier écrit avec le mauvais style passe inaperçu.
Le guide sur la tolérance aux erreurs et aux sommes de contrôle couvre la lecture des codes endommagés et la validation de ce qui est renvoyé. Pour une exécution complète d'une tâche IronQR de bout en bout avec ses propres critères de réussite, consultez le guide des assistants de codage AI.
Qu'est-ce que les messages ont produit lors d'une réelle exécution ?
Nous avons envoyé les trois invites ci-dessus à Claude Code dans l'ordre, en une seule session. Le fichier de la marque contenait trois campagnes, un format affiche de 600 pixels et un format autocollant de 120 pixels, à côté d'un logo carré et d'un mot-symbole large. Une version Release distincte d'une copie propre a ensuite relancé la matrice et écrit un CSV identique, et un décodage indépendant de chaque PNG enregistré a concordé avec chaque ligne.
- À sa première exécution, la matrice a correspondu à 0 des 72 variantes dans les deux modes. Après que Claude Code a retiré le bloc using sur
QrImageInput, 55 sur 72 ont correspondu. - IronQR a refusé 9 variantes à l'enregistrement, chacune avec le logo manuel. Sur les 63 fichiers enregistrés, le scan de base a décodé les 63 et Auto en a décodé 55.
- Pour le Quickstart, Claude Code a choisi un code de 300 pixels avec des marges de 10 pixels et un logo de 50 x 50. Son PNG de 320 x 320 a correspondu à l'URL à la première lecture.
- Le sous-agent n'a trouvé aucun membre d'IronQR manquant dans
IronQr.xml. - Chaque invite a laissé une version Release propre sans modifications manuelles, et les totaux de la matrice correspondent à l'exécution de calibration.
- Une réponse typée a approuvé le plan de la troisième invite à la place de la boîte de dialogue du plan, car la session s'est déroulée de manière non interactive.
Les versions, modèles, calendriers et la machine de test pour ce guide et ses homologues se trouvent dans le registre de l'exécution partagé.
Dépannage
- Appliquez une clé de licence dans IronQR si la construction réussit et que la première écriture déclenche une exception de licence
- Ajoutez un logo aux QR codes si l'enregistrement d'un logo dimensionné manuellement déclenche IronQrException
- Définissez les niveaux de correction d'erreur des QR codes si une variante nécessite plus de redondance pour son logo
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.