Comment utiliser IronPrint avec Claude Code
Un laboratoire hospitalier imprime trois types de documents à partir d'un service. Les étiquettes des spécimens vont à l'imprimante d'étiquettes au bureau de collecte, les rapports de résultats vont à l'imprimante de bureau, et les manifestes de courrier vont à la salle de répartition. Un fichier de routage nomme l'imprimante pour chaque type de document, et un seul caractère erroné dans ce fichier peut envoyer les résultats des patients dans une autre salle sans erreur. Claude Code, l'outil de codage agentique d'Anthropic, édite des fichiers et exécute des commandes dans un dépôt. Il est disponible en tant qu'outil en ligne de commande, en tant qu'extensions pour les éditeurs VS Code et JetBrains, dans l'application de bureau Claude, et sur claude.ai/code.
IronPrint imprime des PDF et des images à partir de .NET, soit silencieusement, soit via la boîte de dialogue du système d'exploitation. La propriété PrintSettings.PrinterName sélectionne l'imprimante pour un travail, et Printer.GetPrinterNames liste les imprimantes installées sur la machine. Les quatre invites testées ci-dessous font que Claude Code crée un routeur d'imprimantes pour ce laboratoire, et les sections entre elles enregistrent le comportement d'IronPrint sur lequel chaque invite repose.
Démarrez claude dans un terminal ouvert dans le dossier du projet et changez le modèle avec /model opusplan avant d'envoyer la première invite. Taper @ avant un chemin inclut le contenu de ce fichier dans la demande.
Add the IronPrint NuGet package, version 2026.10.1, to LabPrintRouter.csproj.
Then have Program.cs check the printer names in @config/printer-routes.json.
The program does this, in order:
1. Applies the license key and prints License.IsLicensed.
2. Prints each name from Printer.GetPrinterNames on its own line, in quotes.
3. Prints each route's document type, its printer name in quotes, and installed or missing.
A route's printer counts as installed only on an exact match, case and spaces included.
Don't send any print job. Every printer on this machine opens a Save dialog.
My key is in the IRONPRINT_LICENSE_KEY environment variable.
Program.cs reads it at startup and assigns it to License.LicenseKey.
Don't print its value, and don't dump the environment to find it.
If you check the variable, a yes or no on whether it's set is enough.
Les guillemets dans la sortie rendent visible un espace final.
Flux de travail minimal (5 étapes)
- Téléchargez la bibliothèque d'impression C# depuis NuGet
- Ouvrez Claude Code à partir du dossier du projet et définissez le modèle avec /model
- Enregistrez les règles de nom d'imprimante d'IronPrint dans CLAUDE.md pour que chaque session les charge.
- Demandez un routeur qui envoie un travail uniquement lorsque le nom configuré correspond exactement à une imprimante installée.
- Examinez le rapport de routage, puis envoyez une page de test à chaque imprimante routée avant la mise en service.
Que fait Claude Code dans un projet d'impression .NET ?
L'agent écrit un service de routage qui lit le fichier de routage, compare chaque nom d'imprimante configuré avec les imprimantes installées, et enregistre une décision pour chaque document. Claude Code peut également exécuter le programme et ses tests et corriger les échecs qu'ils signalent. Le développeur décide quelle imprimante sert chaque type de document.
Indiquez le nom et la version du paquet dans la première invite. Dans l'attaque connue sous le nom de slopsquatting, les attaquants enregistrent des paquets nuisibles sous des noms que les modèles de langage hallucinent. Un agent qui choisit un nom de paquet par lui-même peut installer l'un de ces paquets.
Comment configurer Claude Code ?
L'installation et la première connexion suivent le démarrage rapide d'Anthropic. La configuration est effectuée une fois que claude ouvre une session dans un terminal et répond à une invite.
Comment configurer un projet dans lequel Claude Code peut travailler ?
Placez les entrées dans le dépôt avant la première invite. Le projet d'exemple pour ce guide contient une application de console .NET 9 pour net9.0-windows, un fichier de routage pour quatre types de documents, et une boîte de réception de sept PDF dont les noms commencent par leur type de document. Une route utilise le nom exact d'une imprimante installée. Les trois autres utilisent une imprimante qui n'est pas installée, un nom installé dans une casse différente, et un nom installé suivi d'un espace.
Claude Code lit CLAUDE.md lorsqu'une session démarre, donc ses règles s'appliquent à chaque session ultérieure. Une fois que le démarrage rapide a ajouté le paquet, la deuxième invite écrit ce fichier et définit un sous-agent en lecture seule qui examine le code d'impression.
Add a Printing section to a new CLAUDE.md at the repository root.
Later sessions should follow these rules from it:
- All printing goes through IronPrint. Add no other printing library.
- The package is IronPrint, at the version LabPrintRouter.csproj references now.
- Look up IronPrint member names in docs/IronPrint.xml.
- config/ and inbox/ are inputs. Leave them unchanged.
- The program sends no print job unless it runs with --send.
- Never run it with --send on this machine.
- Read the key from IRONPRINT_LICENSE_KEY. Never print it, save it, or dump the environment.
Copy IronPrint.xml to docs/ now, from the ironprint 2026.10.1 folder of the local NuGet cache.
Use the one under lib/net7.0-windows7.0.
If it isn't there, tell me, and still add the subagent below.
Then create a subagent at .claude/agents/printer-name-auditor.md.
Limit its tools to Read, Grep and Glob.
It reviews Services/ and returns three lists:
- IronPrint types and members in use, flagging any that docs/IronPrint.xml lacks.
- Types under IronSoftware.*, listed apart, since they ship in other assemblies.
- Every place a PrinterName gets set, and whether that name passed an exact installed check first.
Claude Code surveille .claude/agents et charge une définition de sous-agent nouvellement ajoutée sans redémarrage, mais uniquement lorsque ce dossier existait au début de la session. Le dépôt d'exemple contient donc le dossier, avec un fichier .gitkeep vide, avant l'ouverture de la session. Le llms.txt de IronPrint indexe ses guides pratiques, ses compétences d'agent, et sa documentation.
Appliquez la clé de licence avant le premier appel d'impression. Sans clé, Printer.Print et Printer.PrintAsync échouent, et aucun travail n'est mis en file d'attente. La page IronPrint License Keys offre une clé d'essai et montre à la fois l'attribution de code et le paramétrage du fichier de configuration.
Quelles règles d'imprimante IronPrint appartiennent à CLAUDE.md ?
Nous avons sondé le comportement derrière chaque ligne sur IronPrint 2026.10.1, une fois licencié et une fois non licencié. Collez le bloc dans la section Impression.
These printer rules come from probes on IronPrint 2026.10.1:
- PrintSettings.PrinterName must equal a Printer.GetPrinterNames() entry, character for character.
- Any other name sends the job to the Windows default printer, and nothing throws.
- That covers a missing printer, a different case, a trailing space and an empty string.
- Decide whether to print with StringComparison.Ordinal.
- A trimmed or case-blind match may label a near miss, but it never sends a job.
- Printer.GetPrinterTrays() returns an empty list for a name that isn't installed.
- An empty tray list is also normal for some real printers, so it can't test a name.
- Printer.GetPrinterNames() works without a key, so a printer list proves nothing about licensing.
- IronPrint doesn't read IRONPRINT_LICENSE_KEY by itself. Assign License.LicenseKey at startup.
- Assigning a null key doesn't throw. License.IsLicensed just stays false.
- Without a key, Printer.Print throws AggregateException with a LicensingException inside.
- Without a key, Printer.PrintAsync throws LicensingException directly.
- LicensingException is IronSoftware.Exceptions.LicensingException, internal to IronPrint.dll.
- Print and PrintAsync both wait on the driver, and a Save dialog keeps them waiting.
Les deux formes d'exception influencent la gestion des erreurs. Un gestionnaire vérifie l'exception de PrintAsync mais l'exception interne de Print. Aucun des deux ne peut utiliser catch (LicensingException), car le type n'est pas public et cette clause a échoué avec CS0122 dans la sonde.
IronPrint rejette-t-il un nom d'imprimante qui ne correspond pas ?
Selon le guide de spécification de nom d'imprimante, la comparaison de noms est sensible à la casse, et un mauvais nom échoue soit silencieusement soit soulève une erreur. Notre sonde a envoyé un rapport de deux pages sous quatre noms qui ne correspondaient à aucune imprimante installée. Les noms étaient un nom d'imprimante non installée, "adobe pdf" pour l'installé "Adobe PDF", le nom installé suivi d'un espace, et une chaîne vide. Aucun des quatre appels n'a échoué, et chaque travail a été envoyé à la file d'attente par défaut, qui sur la machine de test est Microsoft Print to PDF.
Le routeur doit donc comparer chaque nom configuré avec les noms installés lui-même, avant d'appeler la méthode d'impression.
Comment IronPrint construit-il un travail d'impression ?
IronPrint envoie chaque page PDF au pilote comme une image à la résolution dans PrintSettings.Dpi. Le travail sonde vers Microsoft Print to PDF a produit un PDF A4 de deux pages dans lequel chaque page était une seule image de 1239 par 1754 pixels sans calque de texte, rendu à 150 DPI. Les sorties d'exemple sur le guide suivent le même schéma à la valeur par défaut de 300 DPI, avec 2479 par 3508 pixels par page A4. Une vérification de la sortie d'une imprimante PDF doit donc comparer les comptes de page ou les images, car le texte imprimé ne peut pas être recherché.
Pour inspecter des travaux sans les imprimer, la configuration de test a accroché l'appel d'impression WPF qu'IronPrint utilise sur Windows. Le crochet écrit chaque travail sur le disque au format XPS et ne met rien en file d'attente, et les images de page enregistrées mesuraient 1239 par 1754 pixels, comme le travail sonde. IronPrint écrit les autres paramètres dans le ticket d'impression du travail. Avec Grayscale activé, le ticket a demandé une sortie monochrome. Les images des pages étaient stockées en RVB et ne contenaient que des pixels gris. Le nombre de copies du ticket provenait de NumberOfCopies, et le travail conservait chaque page une fois.
La route d'étiquette montre ce qu'un retour en arrière fait à un travail. L'entrée est specimen-label__S-031.pdf, une étiquette de 100 par 50 mm de la boîte de réception, que le fichier de routage envoie à LAB-ZEBRA-01 à 300 DPI avec PaperSize.PrinterDefault.
Sortie
Les paramètres de la route d'étiquette ont été envoyés sans vérification du nom, de sorte que le travail est revenu à Microsoft Print to PDF. Le format de papier par défaut de l'imprimante a ensuite été résolu en feuille A4 de cette imprimante, et l'étiquette est devenue une image de 1179 par 591 pixels sur une page A4 en mode paysage. Le travail a mis à l'échelle cette image à 297 par 149 mm, la largeur totale de la feuille.
L'étiquette de spécimen S-031 comme IronPrint a construit le travail sans vérification du nom. Une page A4 en mode paysage à 300 DPI, adressée à Microsoft Print to PDF et capturée sur un fichier à la place d'une imprimante.
Comment solliciter du code IronPrint qui compile ?
Envoyez le routeur et son rapport comme une seule invite en mode plan, afin que le design soit approuvé avant tout changement de fichier. Appuyez sur Maj+Tab jusqu'à ce que la barre d'état indique le mode plan, puis envoyez l'invite. Sous opusplan, le plan vient d'Opus, et Sonnet effectue les modifications après approbation du plan.
Build the router in Services/PrintRouter.cs and the report in Services/RoutingReport.cs.
Call both from Program.cs after the printer check.
Program.cs passes PrintRouter the list from one Printer.GetPrinterNames call.
Each PDF in inbox/ is named <documentType>__<id>.pdf.
For each file, PrintRouter does this:
1. Finds the route for its document type in config/printer-routes.json.
2. Checks the route's printer against that list.
3. Builds PrintSettings from the route's paper size, orientation, DPI, copies and grayscale.
4. Sends the job with Printer.PrintAsync, but only under --send.
Each file gets the first of these decisions that fits:
- send, when the printer name matches an installed name exactly.
- name-mismatch, when it matches one after ignoring case and outer spaces.
- not-installed, when nothing matches.
- no-route, when the config has no route for the type.
Only send files reach the print call.
Put that call behind an interface so tests can use a fake.
Write out/routing-report.csv with a header row and one row per file, sorted by file name.
Its first columns are File, DocumentType, ConfiguredPrinter, Decision and InstalledName.
Then come PaperSize, Orientation, Dpi, Copies and Grayscale from the route.
InstalledName holds the installed printer for send and the near match for name-mismatch.
It stays empty for the other two decisions.
A no-route row leaves the five route columns empty too.
Write Grayscale as true or false.
Print a count of files per decision.
Run the program without --send and show me the CSV.
Then have the printer-name-auditor subagent review Services/.
Deux parties de l'invite protègent le routage.
- Le drapeau d'envoi : sans
--send, le programme n'envoie aucun travail, donc l'agent peut exécuter et tester le routeur sur une machine dont les imprimantes ouvrent un dialogue. - Le sous-agent auditeur : un sous-agent personnalisé charge CLAUDE.md, donc les règles de nom d'imprimante s'appliquent également à sa révision. Parmi les agents intégrés, Explore et Plan démarrent sans CLAUDE.md.
Le code de routage IronPrint peut-il être testé sans clé de licence ?
Oui, à condition que les tests remplacent l'appel d'impression. Lire le fichier de routage, lister les imprimantes installées, et construire PrintSettings fonctionnent sans clé, donc chaque décision de routage peut être testée sur un serveur de build qui ne détient pas de clé.
Add a LabPrintRouter.Tests xUnit project that targets net9.0-windows.
It tests PrintRouter through a fake print sink.
The tests read the copies of inbox/ and config/ in their output folder.
Give the router a fixed printer list of "Adobe PDF", "Microsoft Print to PDF" and "Fax".
Assert these results:
- The decision for each of the 7 files.
- The fake receives the 2 result reports and nothing else.
- RPT-4471 goes out with A4, Portrait, 150 DPI, 1 copy and grayscale on.
- Printer.GetPrinterNames runs without throwing while no key is applied.
Set the project up this way:
- It lives in its own folder, and the repository root gets no solution file.
- LabPrintRouter.csproj must not compile anything in that folder.
- The test output folder gets copies of config/ and inbox/.
Run dotnet test one time, in a child process that has no IRONPRINT_LICENSE_KEY.
Tell me the pass count from that run.
Que devez-vous vérifier avant de faire confiance au code IronPrint généré ?
Examinez le code IronPrint généré avec ces vérifications.
- La compilation : un membre qu'IronPrint n'a pas arrête
dotnet buildavec une erreur de compilation. Le IronPrint.xml fourni documente également une méthode de la classe internePdfiumUtils, et le code qui l'appelle échoue avec CS0122. - Le rapport de routage : comparez chaque décision avec le fichier de routage et la liste des imprimantes installées avant le premier travail réel.
- Une page de test par imprimante : avant la mise en service, confirmez sur chaque appareil qu'une page de test est imprimée là où la route le dit.
Le guide des assistants de codage AI propose une tâche IronPrint complète, avec des critères de réussite fixes, comme un test reproductible.
Qu'est-ce que les messages ont produit lors d'une réelle exécution ?
Les quatre invites ont été exécutées dans une seule session Claude Code, dans l'ordre montré. Avant l'invite 3, le bloc de règles a été collé dans CLAUDE.md, et personne n'a édité le code manuellement.
- La sortie du démarrage rapide a nommé les quatre imprimantes installées et a marqué une route installée et trois manquantes.
- Le rapport de routage contenait une ligne pour chacun des 7 fichiers.
- 2 fichiers étaient marqués envoyés, 2 correspondance de nom, 2 non installés, et 1 sans route.
- Chaque décision correspondait à notre vérification indépendante par rapport aux imprimantes installées.
- La correspondance proche était Adobe PDF pour le manifeste de courrier et Microsoft Print to PDF pour le résumé de service.
- Une exécution Release propre dans une copie fraîche a produit le même rapport.
- Sans la clé, le programme a signalé IsLicensed comme False et a pris les mêmes 7 décisions.
- 10 sur 10 tests ont été réussis dans un processus sans variable IRONPRINT_LICENSE_KEY.
- Le sous-agent n'a trouvé aucun membre IronPrint manquant de IronPrint.xml.
- Le sous-agent a trouvé une assignation de nom d'imprimante, placée après la vérification exacte.
- Les files d'attente d'impression étaient vides après l'exécution, et aucune commande dans les transcriptions n'a utilisé --send.
- La capture des deux travaux envoyés contenait 3 pages portrait A4 pour la file d'attente Adobe PDF, chacune une image de 1239 par 1754 pixels.
- Chaque invite a laissé une construction Release sans avertissements ni erreurs.
- Un scan des transcriptions, des fichiers de session, et du dépôt n'a trouvé aucune copie de la clé de licence.
- Certaines étapes ont été exécutées différemment de la page. Une réponse tapée a approuvé le plan de l'invite 3, car la session s'est déroulée en arrière-plan. Aucun travail n'a été imprimé, car chaque imprimante sur la machine de test ouvre un dialogue de sauvegarde, donc les deux travaux envoyés ont été capturés en XPS.
La première ligne envoyée dans le rapport de routage était result-report__RPT-4471.pdf, un rapport de résultats de deux pages de la boîte de réception.
Sortie
L'outil de capture a transmis les paramètres de cette ligne du rapport de routage à IronPrint. Le PDF ci-dessous contient les deux pages capturées sans modifications.
Rapport de résultats RPT-4471 comme IronPrint a construit le travail envoyé à partir du rapport de routage de l'exécution. Les deux pages sont portrait A4 à 150 DPI pour la file d'attente Adobe PDF, capturées sur un fichier à la place d'une imprimante.
Cursor a un mode plan également, et le guide Cursor envoie son invite 3 dedans. Codex lit ses règles de projet à partir de AGENTS.md, le pendant de CLAUDE.md, comme le montre le guide ChatGPT Codex. La version Claude Code de cette exécution, les modèles, et la durée totale apparaissent dans le rapport d'exécution à côté de la machine de test.
Dépannage
- La méthode Print() se bloque dans WPF et WinForms quand
Printbloque le fil d'interface utilisateur. - La configuration de licence web.config quand une clé définie dans Web.config n'est pas appliquée
- Comportement de ShowPrintDialog sur des frameworks cibles non pris en charge pour les appels
ShowPrintDialogsur un framework cible sans support d'interface utilisateur
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.