Wie man IronQR mit Claude Code verwendet

Curtis Chau
Curtis Chau
Aktualisiert: 9. Oktober 2026

Das Marketingteam verlangt, dass jeder Kampagnen-QR-Code die marineblaue Farbe der Marke nutzt, das Logo in der Mitte zeigt und sowohl in Plakat- als auch in Aufklebergröße verfügbar ist. Jedoch kann jede zusätzliche stilistische Wahl die Zuverlässigkeit der Erkennung reduzieren. Zum Beispiel kann ein Logo Module verdecken, ein heller Vordergrund den Kontrast verringern und kleinere Druckgrößen die Pixeldichte senken. Ein QR-Code mag auf dem Bildschirm korrekt erscheinen, versagt jedoch möglicherweise in der realen Anwendung. Claude Code, Anthrowpiks Codierungsagent, arbeitet über Terminals, VS Code, JetBrains, Desktop-Anwendungen und das Web hinweg. In jeder Umgebung liest er das Projekt, bearbeitet Dateien und führt Befehle aus, sodass er gestylte Codes rendern, gespeicherte Dateien dekodieren und das Styling anpassen kann, bis die Nutzlast erhalten bleibt.

IronQR generiert und liest QR-Codes innerhalb desselben .NET-Prozesses, sodass der Agent nach jeder Änderung scannen kann. Die Bibliothek lehnt automatisch einige unlesbare Designs ab. Ein manuell dimensioniertes Logo, das zu viel abdeckt, oder eine Vordergrundfarbe, die zu nahe an einem weißen Hintergrund ist, löst beim Speichern eine IronQrException aus. Andere stilistische Entscheidungen können erfolgreich gespeichert werden, aber später dennoch nicht dekodiert werden. Der zuverlässigste Ansatz ist, eine Matrix von stilisierten Varianten zu testen und jede gespeicherte PNG zu dekodieren. Dieser Leitfaden erklärt, wie Claude Code für diesen Prozess konfiguriert wird, mit drei getesteten Eingaben und dem IronQR-Verhalten, auf dem jede basiert.

Eine einzelne Modelleinstellung unterstützt alle drei Eingaben. Der opusplan-Alias verwendet Opus im Planmodus und Sonnet ansonsten, was für eine Sitzung geeignet ist, in der nur der Matrixbau Planung erfordert.

Schnellstart
NuGetMit NuGet installieren

PM > Install-Package IronQR

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

Öffnen Sie den Projektordner in einem Terminal, starten Sie Claude Code und führen Sie /model opusplan aus. Geben Sie @ vor einem Dateipfad ein, um Claude Code diese Datei zu übergeben, und senden Sie dann die Anfrage.

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

Die direkteste Version dieses Codes kann fehlschlagen. In unseren Untersuchungen wurde der Spring-Sale-Code auf dem Standard-Fehlerkorrekturlevel mit einem automatisch dimensionierten Logo ohne Fehler gespeichert, dann leer zurückgelesen oder im Standard-Scanmodus des Lesers eine ObjectDisposedException ausgelöst. Ein manuelles 100-Pixel-Logo auf einem 500-Pixel-Code wurde korrekt zurückgelesen.

Überprüfen Sie zuerst die gedruckte Breite. In unserer Untersuchung führten Stiloptionen ohne festgelegte Größe zu einem 49-Pixel-Bild für diese URL.



Was macht Claude Code in einem .NET QR-Code-Projekt?

Der Agent schreibt den Renderer, liest die Marken-Datei, speichert ein PNG pro Variante, dekodiert jede Datei und berichtet, welche Designs standhalten. Sie sagen, welche Varianten die Kampagne benötigt, und überprüfen die zurückkommende Tabelle.

Gebrandete Codes machen diese Überprüfung lohnenswert zu automatisieren, weil Logo-Größe, Fehlerkorrekturlevel und Pixelgröße interagieren. Im getesteten Ablauf hat IronQR ein manuelles Logo zu 30 Prozent der Breite auf einem 600-Pixel-Code gespeichert und dasselbe Verhältnis bei 120 Pixeln für eine Kampagne verweigert, während eine andere Kampagne das Gegenteil zeigte.

Nennen Sie IronQR als die einzige QR-Bibliothek ab der ersten Eingabe. Ein Agent, der einen Paketnamen errät, kann ein ähnlich aussehendes veröffentlicht bekommen, um diese Vermutung abzufangen, ein Angriff namens slopsquatting.

Wie richten Sie Claude Code ein?

Installieren Sie Claude Code mit Anthropics Quickstart und melden Sie sich an. Wenn er in einem Terminal startet und antwortet, ist er bereit.

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

Bereiten Sie das Repository vor der ersten Eingabe vor. Ein .NET-9-Konsolenprojekt, das gebaut wird, eine Brand/campaigns.json-Datei mit der URL und den Farben jeder Kampagne sowie die Logo-Dateien geben dem Agenten reale Eingaben, mit denen er arbeiten kann. Starten Sie Claude Code aus diesem Ordner, sodass die Sitzung darauf beschränkt ist.

Claude Code liest CLAUDE.md zu Beginn jeder Sitzung, was der Ort für Regeln ist, die länger als eine Eingabe bestehen sollen. Sobald der Schnellstart das Paket hinzugefügt hat, schreibt eine zweite Eingabe die Datei.

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

Der XML-Pfad ist wichtig, da die Stil- und Lesetypen im IronQR.Slim-Paket enthalten sind, auf das IronQR angewiesen ist, sodass die Mitgliederliste in diesem Ordner des Caches sitzt. Für Anleitungen über die Mitgliederliste hinaus veröffentlicht IronQR einen Index für Agenten auf llms.txt.

Kümmern Sie sich um die Lizenz, bevor Sie das erste Rendern durchführen. Ohne Schlüssel werfen sowohl QrWriter.Write als auch QrReader.Read eine LicensingException, deren Nachricht lautet „Produktionslizenz erforderlich“, und es gibt keine mit Wasserzeichen versehene Testausgabe, auf die zurückgegriffen werden kann. Dieser Ausnahme-Typ ist nicht öffentlich, also lassen Sie das Programm License.IsLicensed prüfen, nachdem Sie den Schlüssel aus IRONQR_LICENSE_KEY gesetzt haben, anstatt die Ausnahme beim Namen zu fangen. Die Seite IronQR License Keys behandelt den Erwerb eines Schlüssels und die Orte, wo IronQR ihn liest.

Welche IronQR-Einstellungen gehören in CLAUDE.md?

Jede Zeile wurde gegen IronQR 2026.10.1 überprüft, entweder durch den Bau einer Untersuchung oder durch das Ausführen einer mit einem lizenzierten Schlüssel. Fügen Sie den Block unter dem Abschnitt QR-Codes ein.

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

Schwarze Module auf einem schwarzen Hintergrund wurden ohne Ausnahme gespeichert, und kein Scanmodus konnte die Datei dekodieren.

Wie kontrollieren Sie die Größe, Ränder und Farben eines QR-Codes?

Ein QrStyleOptions-Objekt enthält jede visuelle Wahl. Save wendet es an und gibt ein Bitmap zurück, das Sie mit SaveAs auf die Festplatte schreiben. Das Fehlerkorrekturlevel ist die eine Einstellung, die woanders, in QrOptions, liegt, weil es das kodierte Symbol selbst verändert.

Dimensions setzt die Codegröße in Pixeln und Margins die Ruhezone auf allen vier Seiten, während MarginTop und die anderen Seiten jeweils eine Seite setzen. Color malt die dunklen Module und BackgroundColor den hellen Bereich und die Ränder. Logo nimmt ein QrLogo mit dem Bitmap, der Breite, der Höhe und dem Eckenradius.

In unserer Untersuchung speicherte ein 400-Pixel-Code mit 50-Pixel-Rändern oben und unten und 20-Pixel-Rändern an den Seiten mit 440 x 500. Der Größenleitfaden, der Ränder-Leitfaden und der Farben-Leitfaden zeigen jede Einstellung für sich.

Bitte beachten Sie: Ein Aufruf von Save ohne Argument bei einem Code, der nie gestylt wurde, gibt ein 250 x 250 Bild zurück. Diese Größe ist ein interner Standard.

Wie groß kann ein Logo bei jedem Fehlerkorrekturlevel sein?

Kleiner als die Fehlerkorrektur-Prozentsätze suggerieren. Diese Zahlen zählen die Codewörter, die Reed-Solomon-Dekodierung wiederherstellen kann, und ein zentrales Logo ist nur eine Schadensquelle. Wir haben die Spring-Sale-URL bei 600 Pixeln mit einem einfachen quadratischen Logo gerendert, IronQR es automatisch dimensionieren lassen und dann manuell die Größe um jeweils ein Prozent erhöht, bis IronQR sich weigerte, es zu speichern.

EbeneDokumentierte WiederherstellungAutomatisches Logo (Breite, Fläche)Größtes manuelles Logo (Breite, Fläche)
Niedrig7%20 %, 4,0 %23 %, 5,3 %
Medium15%30 %, 9,0 %31 %, 9,6 %
Hoch25%32,5 %, 10,6 %39 %, 15,2 %
Höchste30%32 %, 10,2 %44 %, 19,4 %

In der 2026.10.1-Assembly versucht die automatische Dimensionierung eine kurze Liste von Brüchen der Codebreite, von einer Hälfte bis zu einem Zwanzigstel, und behält den ersten, den ihr Leser dekodiert. Diese Liste erklärt, warum Hoch und Höchst nahe ein Drittel der Breite liegen. Eine manuelle Größe geht höher, auf etwa 60 bis 75 Prozent der dokumentierten Wiederherstellung nach Fläche, aber IronQR prüft sie mit seinem eigenen Leser in voller Auflösung. Ein zweiter Scanmodus kann trotzdem fehlschlagen, wo diese Prüfung bestanden wurde.

Die Zahlen hängen von der Nutzlast ab. Eine längere URL erzeugt ein dichteres Symbol mit anderen Grenzen, also behandeln Sie die Tabelle als Form des Kompromisses und lassen Sie die Matrix Ihre eigenen Kampagnen messen.

Wie testen Sie jede gestaltete IronQR-Variante in einer Eingabe?

Fordern Sie das gesamte Gitter in einer Eingabe an und lassen Sie den Planmodus zuerst das Design festlegen. Drücken Sie Shift+Tab, bis die Statusleiste den Planmodus zeigt, und senden Sie dann die Eingabe.

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

Jeder Punkt schließt eine Möglichkeit, dass die Ergebnisse besser aussehen als sie sind.

  1. Jede Kombination wird benannt: Drei Kampagnen, vier Level, drei Logo-Modi und zwei Größen ergeben 72 Varianten, so dass eine fehlende Zeile in out/scan-matrix.csv sichtbar ist.
  2. Speicherfehler sind Reihen: Ein verweigertes Speichern ist ein Ergebnis, und diese Zeilen zeigen, wo die Logo-Größenbeschränkung liegt.
  3. Ein neuer Leser für jedes Lesen: Ein fehlschlagendes Lesen kann das nächste nicht beeinflussen.
  4. Ein zweiter Agent überprüft die API: Der allgemeine Zweck-Subagent lädt CLAUDE.md, das die eingebauten Explore- und Plan-Subagenten überspringen, sodass die Prüfung die Regeln des Projekts sieht.
Tipps: Genehmigen Sie den Plan erst, nachdem er jede Variante auflistet und einen Try-Block um jede zeigt.

Was sollten Sie verifizieren, bevor Sie generierter IronQR-Code vertrauen?

QrScanMode.Auto greift nur auf den normalen Scan zurück, wenn sein Detektionsmodell nichts findet, und die Dokumentation des Enums beschreibt ihn als das Detektionsmodell zuerst, dann „einen grundlegenden Brute-Force-Scan, wenn keine gefunden werden“. Wenn das Modell den Code findet, ihn aber nicht dekodieren kann, gibt Auto ein leeres Ergebnis zurück, und der Grundscan läuft nie.

Der Grundscan dekodierte jede Quickstart-Variante, die oben fehlschlug, und die Ausnahme kommt von innerhalb IronQR 2026.10.1. In unserem Kalibrierungslauf der vollständigen Matrix hatte jede von Auto verpasste Datei ein Logo, und sechs der acht waren bei Hoch oder Höchst, den beiden Stufen mit der meisten Redundanz, die für ein Logo ausgegeben werden kann. Im getesteten Lauf mit einem flachen 10-Pixel-Rand, den der Agent gewählt hat, hatten zwei der acht Auto-Fehllösungen überhaupt kein Logo.

Fügen Sie diese Prüfungen der selben Überprüfung hinzu.

  • Der Build: Ein erfundener Member scheitert dotnet build, ebenso wie eine Using-Direktive, die IronQR buchstabiert, die das Paket-Casing verwendet, während der Namespace IronQr lautet.
  • Die Größen: Vergleichen Sie jede gespeicherte Breite mit der angeforderten Größe plus beider Seitenränder. Eine Abweichung zeigt einen Stil, der den Speicheraufruf nie erreicht hat.
  • Die Nutzlast: Dekodieren Sie die Datei auf der Festplatte. Verify vergleicht Text mit IronQRs eigener In-Memory-Darstellung, sodass ein Dateipfad Falsch zurückgibt und eine Datei, die mit dem falschen Stil geschrieben wurde, unbemerkt bleibt.

Der Leitfaden zu Prüfsumme und Fehlertoleranz behandelt das Lesen beschädigter Codes und die Validierung dessen, was zurückkommt. Für einen vollständigen IronQR-Aufgabenlauf von Anfang bis Ende mit eigenen Trefferkriterien, siehe den Leitfaden zu KI-Codierungsassistenten.

Was haben die Aufforderungen in einem realen Lauf erzeugt?

Wir schickten die drei obigen Eingaben in Reihenfolge an Claude Code, in einer Sitzung. Die Marken-Datei enthielt drei Kampagnen, eine 600-Pixel-Postergröße und eine 120-Pixel-Aufklebergröße, neben einem quadratischen Logo und einem breiten Wortmarkenlogo. Ein separater Release-Build einer sauberen Kopie führte dann die Matrix erneut aus und schrieb eine identische CSV, und eine unabhängige Dekodierung jeder gespeicherten PNG stimmte mit jeder Reihe überein.

  • Bei seinem ersten Lauf stimmte die Matrix in beiden Modi mit 0 von 72 Varianten überein. Nachdem Claude Code den Using-Block auf QrImageInput entfernt hatte, stimmten 55 von 72 überein.
  • IronQR verweigerte 9 Varianten beim Speichern, jede mit dem manuellen Logo. Von den 63 Dateien, die es speicherte, dekodierte der Grundscan alle 63 und Auto dekodierte 55.
  • Für den Quickstart wählte Claude Code einen 300-Pixel-Code mit 10-Pixel-Rändern und ein 50 x 50 Logo. Sein 320 x 320 PNG stimmte beim ersten Lesezugriff mit der URL überein.
  • Der Subagent fand keinen fehlenden IronQR-Member in IronQr.xml.
  • Jede Eingabe hinterließ einen sauberen Release-Build ohne manuelle Bearbeitungen, und die Matrizen-Totale entsprechen dem Kalibrierungslauf.
  • Eine getippte Antwort genehmigte den Plan der dritten Eingabe anstelle des Plansdialogs, weil die Sitzung nicht interaktiv lief.

Versionen, Modelle, Zeitpläne und die Testmaschine für diesen Leitfaden und seine Geschwister befinden sich in der gemeinsamen Laufaufzeichnung.


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 82,442Version:2026.11gerade veröffentlicht