Verwendung von IronPrint mit Claude Code

Curtis Chau
Curtis Chau
Aktualisiert: 26. Oktober 2026

Ein Krankenhauslabor druckt drei Arten von Dokumenten aus einem Dienst. Probenetiketten gehen an den Etikettendrucker am Sammelschalter, Ergebnisberichte gehen an den Bürodrucker, und Kurierbelege gehen in den Versandraum. Eine Routing-Datei benennt den Drucker für jeden Dokumenttyp, und schon ein falsches Zeichen in dieser Datei kann Patientenergebnisse ohne Fehler in einen anderen Raum senden. Claude Code, das agentengesteuerte Codierungstool von Anthropic, bearbeitet Dateien und führt Befehle in einem Repository aus. Es ist als Befehlszeilen-Tool verfügbar, als Erweiterungen für VS Code und JetBrains-Editoren, in der Claude-Desktop-App und unter claude.ai/code.

IronPrint druckt PDFs und Bilder aus .NET, entweder im Hintergrund oder über das Dialogfeld des Betriebssystems. Die PrintSettings.PrinterName Eigenschaft wählt den Drucker für einen Auftrag aus, und Printer.GetPrinterNames listet die auf dem Computer installierten Drucker auf. Die vier getesteten Eingaben unten lassen Claude Code einen Druckerrouter für dieses Labor erstellen, und die Abschnitte dazwischen dokumentieren das IronPrint-Verhalten, auf das jede Eingabe angewiesen ist.

Schnellstart
NuGetMit NuGet installieren

PM > Install-Package IronPrint

Installieren Sie IronPrint, indem Sie den obigen Befehl in der NuGet Packet Manager-Konsole ausführen, oder suchen Sie das Paket im NuGet Paket Manager.

Starten Sie claude in einem Terminal, das am Projektordner geöffnet ist, und wechseln Sie das Modell mit /model opusplan, bevor Sie die erste Eingabe senden. Beim Tippen von @ vor einem Pfad wird der Inhalt dieser Datei in die Anfrage eingefügt.

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.
Text

Die Anführungszeichen im Ausgang machen ein nachfolgendes Leerzeichen sichtbar.



Was macht Claude Code in einem .NET-Druckprojekt?

Der Agent schreibt einen Routing-Dienst, der die Routing-Datei liest, jeden konfigurierten Druckernamen mit den installierten Druckern vergleicht und eine Entscheidung für jedes Dokument aufzeichnet. Claude Code kann auch das Programm und dessen Tests ausführen und die von ihnen gemeldeten Fehler beheben. Der Entwickler entscheidet, welcher Drucker für jeden Dokumenttyp zuständig ist.

Geben Sie den Paketnamen und die Version in der ersten Eingabe an. Beim Angriff, der als slopsquatting bekannt ist, registrieren Angreifer schädliche Pakete unter Namen, die Sprachmodelle halluzinieren. Ein Agent, der selbst einen Paketnamen auswählt, kann eines dieser Pakete installieren.

Wie richten Sie Claude Code ein?

Die Installation und die erste Anmeldung folgen dem Quickstart von Anthropic. Das Setup ist abgeschlossen, wenn claude eine Sitzung in einem Terminal öffnet und eine Eingabeaufforderung beantwortet.

Wie richten Sie ein Projekt ein, in dem Claude Code arbeiten kann?

Legen Sie die Eingaben vor der ersten Eingabeaufforderung im Repository ab. Das Musterprojekt für diesen Leitfaden enthält eine .NET 9-Konsolen-App für net9.0-windows, eine Routing-Datei für vier Dokumenttypen und einen Posteingang von sieben PDFs, deren Namen mit ihrem Dokumenttyp beginnen. Eine Route verwendet den genauen Namen eines installierten Druckers. Die anderen drei verwenden einen nicht installierten Drucker, einen installierten Namen in anderer Groß- und Kleinschreibung und einen installierten Namen mit einem nachfolgenden Leerzeichen.

Claude Code liest CLAUDE.md, wenn eine Sitzung beginnt, sodass seine Regeln in jeder späteren Sitzung gelten. Nachdem der Quickstart das Paket hinzugefügt hat, schreibt die zweite Eingabeaufforderung diese Datei und definiert einen schreibgeschützten Unteragenten, der den Druckcode überprüft.

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.
Text

Claude Code überwacht .claude/agents und lädt eine neu hinzugefügte Unteragenturdefinition ohne Neustart, aber nur, wenn dieses Verzeichnis zu Beginn der Sitzung existierte. Das Beispiel-Repository enthält daher das Verzeichnis mit einer leeren .gitkeep-Datei, bevor die Sitzung geöffnet wird. IronPrint's llms.txt indexiert seine Anleitungen, seine Agentenfähigkeiten und seine andere Dokumentation.

Wenden Sie den Lizenzschlüssel an, bevor der erste Druckbefehl ausgeführt wird. Ohne einen Schlüssel werfen Printer.Print und Printer.PrintAsync Ausnahmen, und kein Auftrag wird in die Warteschlange gestellt. Die Seite IronPrint License Keys bietet einen Testschlüssel und zeigt sowohl die Codezuweisung als auch die Einstellung der Konfigurationsdatei.

Welche IronPrint-Druckerregeln gehören in CLAUDE.md?

Wir haben das Verhalten hinter jeder Zeile in IronPrint 2026.10.1 getestet, einmal lizenziert und einmal unlizenziert. Fügen Sie den Block im Abschnitt Drucken ein.

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.
Markdown

Die beiden Ausnahmeformen beeinflussen die Fehlerbehandlung. Ein Handler überprüft die Ausnahme von PrintAsync, aber die innere Ausnahme von Print. Keiner kann catch (LicensingException) verwenden, weil der Typ nicht öffentlich ist und dieser Abschnitt mit CS0122 im Test fehlgeschlagen ist.

Lehnt IronPrint einen Druckernamen ab, der nicht übereinstimmt?

Laut dem Anleitung Druckernamen festlegen ist der Namensvergleich groß- und kleinschreibungssensitiv, und ein falscher Name schlägt entweder lautlos fehl oder löst einen Fehler aus. Unser Test hat einen zweiseitigen Bericht unter vier Namen gesendet, die keinem installierten Drucker entsprachen. Die Namen waren ein nicht installierter Druckername, "adobe pdf" für das installierte "Adobe PDF", der installierte Name gefolgt von einem Leerzeichen und eine leere Zeichenfolge. Keiner der vier Aufrufe warf eine Ausnahme, und jeder Auftrag wurde an die Standardwarteschlange gesendet, die auf dem Testgerät Microsoft Print to PDF ist.

Der Router muss daher jeden konfigurierten Namen vor dem Aufruf der Druckmethode mit den installierten Namen vergleichen.

Wie erstellt IronPrint einen Druckauftrag?

IronPrint sendet jede PDF-Seite an den Treiber als Bild in der Auflösung von PrintSettings.Dpi. Der Testauftrag an Microsoft Print to PDF erzeugte ein zweiseitiges A4-PDF, in dem jede Seite ein einzelnes Bild mit 1239 x 1754 Pixeln ohne Textebene war, gerendert bei 150 DPI. Die Beispielausgaben im Leitfaden folgen dem gleichen Muster bei den Standard-300 DPI mit 2479 x 3508 Pixeln pro A4-Seite. Eine Überprüfung der Ausgabe eines PDF-Druckers muss daher Seitenanzahl oder Bilder vergleichen, da der gedruckte Text nicht durchsucht werden kann.

Um Aufträge zu inspizieren, ohne sie zu drucken, hat das Testsetup den WPF-Druckaufruf, den IronPrint unter Windows verwendet, abgefangen. Der Hook schreibt jeden Auftrag auf die Festplatte im XPS-Format und spult nichts, und die gespeicherten Seitenbilder maßen 1239 x 1754 Pixel, genau wie der Testauftrag. IronPrint schreibt die anderen Einstellungen in das Druckticket des Auftrags. Mit Grayscale eingeschaltet, forderte das Ticket monochromen Ausdruck an. Die Seitenbilder wurden als RGB gespeichert und enthielten nur graue Pixel. Die Kopienanzahl des Tickets stammte von NumberOfCopies, und der Auftrag hielt jede Seite einmal.

Die Etikettenroute zeigt, was ein Fallback mit einem Auftrag macht. Die Eingabe ist specimen-label__S-031.pdf, ein 100 x 50 mm Etikett aus dem Posteingang, das die Routing-Datei an LAB-ZEBRA-01 bei 300 DPI mit PaperSize.PrinterDefault sendet.

Ausgabe

Die Einstellungen der Etikettenroute wurden ohne Namensüberprüfung gesendet, sodass der Auftrag auf Microsoft Print to PDF zurückfiel. Die Standardpapiergröße des Druckers wurde dann auf das A4-Blatt dieses Druckers aufgelöst, und das Etikett wurde ein 1179 x 591 Pixel Bild auf einer A4-Landschaftsseite. Der Auftrag skalierte dieses Bild auf 297 x 149 mm, die volle Breite des Blattes.

Probenetikett S-031, da IronPrint den Auftrag ohne Namensüberprüfung erstellte. Eine A4-Landschaftsseite bei 300 DPI, adressiert an Microsoft Print to PDF und an eine Datei anstelle eines Druckers gesendet.

Wie fordern Sie IronPrint-Code an, der kompiliert?

Senden Sie den Router und seinen Bericht als eine Eingabe in den Planmodus, damit das Design vereinbart wird, bevor Dateien geändert werden. Drücken Sie Shift+Tab, bis die Statusleiste den Planmodus anzeigt, und senden Sie dann die Eingabe. Unter opusplan kommt der Plan von Opus, und Sonnet nimmt die Änderungen vor, nachdem der Plan genehmigt wurde.

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/.
Text

Zwei Teile der Eingabe schützen das Routing.

  1. Das Sendeflag: ohne --send sendet das Programm keinen Auftrag, sodass der Agent den Router auf einem Computer testen und ausführen kann, dessen Drucker einen Dialog öffnen.
  2. Der Auditor-Unteragent: ein benutzerdefinierter Unteragent lädt CLAUDE.md, sodass die Druckernamenregeln auch auf seine Überprüfung angewendet werden. Von den eingebauten Agenten starten Explore und Plan ohne CLAUDE.md.
Tipps: Bevor Sie den Plan genehmigen, bestätigen Sie, dass der Name, der IronPrint gegeben wurde, der installierte Name aus der genauen Überprüfung ist. Ein Plan, der Namen unabhängig von der Groß- und Kleinschreibung abgleicht und dann den konfigurierten Namen weitergibt, sendet die Kurier-Manifeste an den Standarddrucker.

Kann IronPrint-Routing-Code ohne Lizenzschlüssel getestet werden?

Ja, vorausgesetzt, die Tests ersetzen den Druckbefehl. Das Lesen der Routing-Datei, das Auflisten der installierten Drucker und das Erstellen von PrintSettings läuft ohne Schlüssel, sodass jede Routing-Entscheidung auf einem Build-Server getestet werden kann, der keinen Schlüssel hat.

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.
Text

Was sollten Sie überprüfen, bevor Sie generiertem IronPrint-Code vertrauen?

Überprüfen Sie den generierten IronPrint-Code mit diesen Überprüfungen.

  • Der Build: ein Mitglied, das IronPrint nicht hat, stoppt dotnet build mit einem Kompilierungsfehler. Das gelieferte IronPrint.xml dokumentiert auch eine Methode der internen PdfiumUtils Klasse, und Code, der sie aufruft, schlägt mit CS0122 fehl.
  • Der Routing-Bericht: vergleichen Sie jede Entscheidung mit der Routing-Datei und der Liste der installierten Drucker, bevor der erste echte Auftrag ausgeführt wird.
  • Eine Testseite pro Drucker: bestätigen Sie vor der Freigabe bei jedem Gerät, dass eine Testseite dort gedruckt wurde, wo die Route es angibt.

Der Leitfaden für KI-Codings-Assistenten bietet eine vollständige IronPrint-Aufgabe mit festen Kriterien für das Bestehen als wiederholbaren Test.

Was haben die Aufforderungen in einem realen Lauf erzeugt?

Die vier Eingaben liefen in einer einzigen Claude-Code-Sitzung in der gezeigten Reihenfolge. Vor Eingabeaufforderung 3 wurde der Regelblock in CLAUDE.md eingefügt, und niemand bearbeitete den Code von Hand.

  • Die Quickstart-Ausgabe benannte alle vier installierten Drucker und markierte eine installierte Route und drei fehlende.
  • Der Routing-Bericht enthielt eine Zeile für jede der 7 Dateien.
  • 2 Dateien waren als gesendet markiert, 2 als Namensübereinstimmung fehlgeschlagen, 2 als nicht installiert und 1 ohne Route.
  • Jede Entscheidung stimmte mit unserer unabhängigen Überprüfung der installierten Drucker überein.
  • Die nahe Übereinstimmung war Adobe PDF für das Kuriermanifeste und Microsoft Print to PDF für die Stationszusammenfassung.
  • Ein sauberer Release-Lauf in einer frischen Kopie erzeugte den gleichen Bericht.
  • Ohne den Schlüssel meldete das Programm IsLicensed als False und traf die gleichen 7 Entscheidungen.
  • 10 von 10 Tests bestanden in einem Prozess ohne IRONPRINT_LICENSE_KEY-Variable.
  • Der Unteragent fand kein IronPrint-Mitglied, das in IronPrint.xml fehlt.
  • Der Unteragent fand eine Druckernamenzuweisung, platziert nach der genauen Überprüfung.
  • Die Druckwarteschlangen waren nach dem Lauf leer, und kein Befehl in den Transkripten verwendete --send.
  • Das Erfassen der beiden gesendeten Aufträge hielt 3 A4-Hochformatseiten für die Adobe PDF-Warteschlange, jede ein 1239 x 1754 Pixel Bild.
  • Jede Eingabe hinterließ einen Release-Build ohne Warnungen oder Fehler.
  • Eine Überprüfung der Transkripte, Sitzungsdateien und des Repositories ergab keine Kopie des Lizenzschlüssels.
  • Einige Schritte liefen anders als die Seite. Eine getippte Antwort genehmigte den Plan für Eingabeaufforderung 3, weil die Sitzung kopflos lief. Kein Auftrag wurde gedruckt, da jeder Drucker auf dem Testgerät einen Speicher-Dialog öffnet, sodass die beiden gesendeten Aufträge in XPS erfasst wurden.

Die erste gesendete Zeile im Routing-Bericht war result-report__RPT-4471.pdf, ein zweiseitiger Ergebnisbericht aus dem Posteingang.

Ausgabe

Das Erfassungstool übertrug die Einstellungen dieser Zeile aus dem Routing-Bericht an IronPrint. Das untenstehende PDF enthält beide erfassten Seiten ohne Änderungen.

Ergebnisbericht RPT-4471, da IronPrint den Sendeauftrag aus dem Routing-Bericht des Laufs erstellte. Beide Seiten sind A4 Hochformat bei 150 DPI für die Adobe PDF-Warteschlange, erfasst in einer Datei anstelle eines Druckers.

Cursor hat ebenfalls einen Planmodus, und der Cursor-Leitfaden sendet darin seine Eingabeaufforderung 3. Codex liest seine Projektregeɡln̴ aus AGENTS.md, ᵋin der Gegenstück zu CLAUDE.md, wie der ChatGPT Codex-Leitfaden zeigt. Die Version dieses Laufs von Claude Code, Modelle und Gesamtdauer erscheinen im Laufprotokoll neben dem Testgerät.


Fehlerbehebung


Fragen?

Wenn Sie Fragen haben, wenden Sie sich an support@ironsoftware.com.

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.

Mehr lesen

Bereit loszulegen?

NuGet-Downloads 52,106Version:2026.11gerade veröffentlicht