Jak używać IronQR z Claude Code

Curtis Chau
Curtis Chau
Zaktualizowano: 9 października 2026

Zespól marketingowy wymaga, aby kazdy kod QR kampanii uzywal granatowego koloru marki, mial logo w centrum i byl dostepny w rozmiarach plakatu i naklejki. Jednak każda dodatkowa opcja stylizacji może zmniejszyć niezawodność skanowania. Na przykład, logo może zakryć moduły, jasny pierwszy plan może obniżyć kontrast, a mniejsze rozmiary druku zmniejszają gęstość pikseli. Kod QR może wyglądać poprawnie na ekranie, ale wciąż zawodzić w rzeczywistym użyciu. Claude Code, agent kodowania firmy Anthropic, dziala w terminalach, VS Code, JetBrains, aplikacjach desktopowych i w sieci. W każdym środowisku odczytuje projekt, edytuje pliki i uruchamia polecenia, dzięki czemu może renderować stylizowane kody, dekodować zapisane pliki i dostosowywać stylizację, aż ładunek zostanie zachowany.

IronQR generuje i odczytuje kody QR w ramach tego samego procesu .NET, wiec agent moze skanowac po kazdej zmianie. Biblioteka automatycznie odrzuca nieodczytywalne projekty. Logo o manualnie ustawionym rozmiarze, które zaslania zbyt wiele, lub kolor tła zblizony do bialego, wywoluje IronQrException podczas zapisu. Inne opcje stylizacji mogą być zapisane pomyślnie, ale wciąż zawodzić podczas późniejszego dekodowania. Najbardziej niezawodnym podejsciem jest przetestowanie macierzy stylizowanych wariantów i zdekodowanie kazdego zapisanego PNG. Ten przewodnik wyjasnia jak skonfigurowac Claude Code do tego procesu, z trzema przetestowanymi promptami i zachowaniem IronQR, od którego zaleza.

Jedno ustawienie modelu obsluguje wszystkie trzy prompty. Alias opusplan uzywa Opus w trybie planu, a Sonnet w przeciwnym razie, co pasuje do sesji, w której tylko budowa macierzy wymaga planowania.

Szybki start
NuGetInstalacja z NuGet

PM > Install-Package IronQR

Zainstaluj IronQR, wykonując powyższe polecenie w konsoli Menedżera Pakietów NuGet lub wyszukaj pakiet w Menedżerze Pakietów NuGet.

Otworzyć folder projektu w terminalu, uruchomić Claude Code i wykonać /model opusplan. Podać @ przed ścieżką do pliku, aby przekazać plik Claude Code, następnie wysłać żądanie.

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

Najbardziej bezpośrednia wersja tego kodu może zawodzić. W naszych sondazach, kod wiosennej wyprzedazy na domyslnym poziomie korekcji bledów z automatycznie ustawionym logo zostal zapisany bez bledów, a nastepnie odczytany pusty lub wyrzucil ObjectDisposedException w domyslnym trybie skanowania czytnika. Manualne logo o rozmiarze 100 pikseli na kodzie o rozmiarze 500 pikseli zostalo prawidlowo odczytane.

Najpierw sprawdzić szerokość nadruku. W naszej sondzie opcje stylizacji bez ustawionego rozmiaru wydrukowały obraz 49-pikselowy dla tego URL.



Co robi Claude Code w projekcie kodu QR .NET?

Agent pisze renderer, odczytuje plik marki, zapisuje jedno PNG na każdy wariant, dekoduje każdy plik i raportuje, które projekty się sprawdziły. Użytkownik określa, które warianty są potrzebne dla kampanii i przegląda otrzymaną tabelę.

Kody markowe czynia te kontrole warta automatyzowania, poniewaz rozmiar logo, poziom korekcji i rozmiar pikseli wspóldzialaja. W przetestowanym uruchomieniu, IronQR zapisalo manualne logo o 30 procentowym rozmiarze szerokosci na kodzie o rozmiarze 600 pikseli i odrzucilo to samo proporcje przy 120 pikselach dla jednej kampanii, a inna kampania pokazala odwrotnosc.

Nazwij IronQR jako jedyna biblioteke kodów QR od pierwszego prompta. Agent, który próbuje odgadnac nazwe pakietu, moze zainstalowac podobnie brzmiacy, opublikowany w celu przechwycenia tej próby, atak zwany slopsquatting.

Jak skonfigurować Claude Code?

Zainstalować Claude Code z szybkiego startu Anthropic i zalogować się. Kiedy uruchamia się w terminalu i odpowiada, jest gotowy.

Jak skonfigurować projekt, w którym Claude Code może pracować?

Przygotować repozytorium przed pierwszym promptem. Projekt konsolowy .NET 9, który buduje się, plik Brand/campaigns.json z adresem URL i kolorami każdej kampanii, a także pliki z logo, dają agentowi prawdziwe dane do pracy. Uruchomić Claude Code z tego folderu, aby sesja była do niego ograniczona.

Claude Code odczytuje CLAUDE.md na początku każdej sesji, co czyni to miejsce idealnym na zasady, które powinny przetrwać więcej niż jeden prompt. Gdy Quickstart doda pakiet, drugi prompt pisze plik.

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

Ścieżka XML jest ważna, ponieważ typy stylizacji i odczytu są dostarczane w pakiecie IronQR.Slim, od którego zależy IronQR, więc lista członków znajduje się w tym folderze cache'u. Dla przewodników poza lista członków, IronQR publikuje indeks dla agentów pod llms.txt.

Obsłużyć licencję przed pierwszym renderowaniem. Bez klucza, zarówno QrWriter.Write, jak i QrReader.Read wyrzuca LicensingException z komunikatem "Required License Required", a nie ma podreslaniego próbnego wyjscia do cofania. Ten typ wyjątku nie jest publiczny, więc program powinien sprawdzić License.IsLicensed po ustawieniu klucza z IRONQR_LICENSE_KEY zamiast łapania wyjątku po nazwie. Strona IronQR License Keys obejmuje pobieranie klucza i miejsca, z których IronQR go odczytuje.

Które ustawienia IronQR naleza do CLAUDE.md?

Kazda linia zostala sprawdzona pod wzgledem zgodnosci z IronQR 2026.10.1 poprzez zbudowanie sondy lub uruchomienie jej z licencjonowanym kluczem. Wklej blok pod sekcją kodów QR.

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

Czarne moduly na czarnym tle zapisane bez wyjątku, a zaden tryb skanowania nie mógl dekodowac pliku.

Jak kontrolujes rozmiar, marginesy i kolory kodu QR?

Jeden obiekt QrStyleOptions trzyma wszystkie wybory wizualne. Save stosuje go i zwraca bitmapę, którą zapisać na dysku za pomocą SaveAs. Poziom korekcji błędów jest jedynym ustawieniem, które znajduje się gdzie indziej, w QrOptions, ponieważ zmienia zakodowany symbol.

Dimensions ustawia rozmiar kodu w pikselach, a Margins ustawia cichą strefę z każdej strony, podczas gdy MarginTop i inne strony ustawiają jedną stronę każda. Color maluje ciemne moduly, a BackgroundColor maluje jasne obszar i marginesy. Logo przyjmuje QrLogo z bitmapą, szerokość, wysokość i promień narożników.

W naszej sondzie, kod o rozmiarze 400 pikseli z marginesami 50-pikselowymi z góry i dołu oraz 20-pikselowymi z boków zapisał się w 440 x 500. przewodnik po zmianie rozmiaru, przewodnik po marginesach, i przewodnik po kolorach pokazują każdy ustawienie osobno.

Uwaga: Wywołanie Save bez argumentu na kodzie, który nigdy nie był stylizowany, zwraca obraz 250 x 250. Ten rozmiar jest wewnętrznym domyślnym

.

Jak duże może być logo na każdym poziomie korekcji błędów?

Mniejsze niż sugerują procenty korekcji. Te wartości liczą kody Reed-Solomon dekodowania, które można odbudować, a centralne logo jest tylko jednym źródłem uszkodzenia. Stworzyliśmy URL wyprzedaży wiosennej na 600 pikseli z prostym kwadratowym logo, pozwoliliśmy IronQR automatycznie ustawić jego rozmiar, a następnie podnosiliśmy ręcznie rozmiar o jeden procent na raz, aż IronQR odmówił jego zapisu.

PoziomSpotykanie zadeklarowaneLogo automatyczne (szerokość, powierzchnia)Największe logo manualne (szerokość, powierzchnia)
Niski7%20%, 4.0%23%, 5.3%
Medium15%30%, 9.0%31%, 9.6%
Wysoka25%32.5%, 10.6%39%, 15.2%
Najwyższa30%32%, 10.2%44%, 19.4%

W złożeniu 2026.10.1 automatyczne rozmiarowanie próbuje krótkiej listy ułamków szerokości kodu, od jednej drugiej w dół do jednej dwudziestej, i zachowuje pierwszą, którą jego czytnik dekoduje. Ta lista wyjaśnia, dlaczego wysoki i najwyższy kończą się w pobliżu jednej trzeciej szerokości. Rozmiar ręczny idzie wyżej, do około 60 do 75 procent udokumentowanego odzysku według powierzchni, ale IronQR sprawdza go swoimi własnymi czytnikiem przy pełnej rozdzielczości. Drugi tryb skanowania może nadal zawieść tam, gdzie to sprawdzanie przeszło.

Wartości zależą od ładunku. Dłuższy URL produkuje gęstszy symbol z innymi ograniczeniami, więc należy traktować tabelę jako kształt kompromisu i pozwolić, aby macierz mierzyła własne kampanie.

Jak przetestować każdy stylizowany wariant IronQR w jednym promptzie?

Poprosić o całą siatkę w jednym promptzie i pozwolić, by tryb planu ustalił projekt najpierw. Nacisnąć Shift+Tab, aż pasek stanu pokaże tryb planu, następnie wysłać prompt.

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

Każda klauzula zamyka sposób, w jaki wyniki mogłyby wyglądać lepiej niż w rzeczywistości są.

  1. Każda kombinacja jest nazwana: trzy kampanie, cztery poziomy, trzy tryby logo i dwa rozmiary tworzą 72 warianty, więc brakujący wiersz w out/scan-matrix.csv jest widoczny.
  2. Niepowodzenia zapisu są wierszami: odmowa zapisu jest wynikiem, a te wiersze pokazują, gdzie leży limit rozmiaru logo.
  3. Świeży czytnik dla każdego odczytu: jedno nieudane odczytanie nie może wpłynąć na następne.
  4. Drugi agent sprawdza API: uniwersalny subagent ładuje CLAUDE.md, co pomijają wbudowane subagenty Explore i Plan, więc sprawdzanie widzi zasady projektu.
Porady: Zatwierdz plan tylko wtedy, gdy wymienia każdy wariant i pokazuje blok try wokół każdego z nich

.

Co należy zweryfikować przed zaufaniem generowanemu kodowi IronQR?

QrScanMode.Auto powraca do podstawowego skanowania tylko wtedy, gdy jego model wykrycia niczego nie znajduje, a dokumentacja enumu opisuje go jako model detekcji najpierw, a następnie "podstawowe brutalne przeczytanie, jeśli żaden nie zostanie znaleziony". Kiedy model znajdzie kod, ale nie może go zdekodować, Auto zwraca pusty wynik, a podstawowe skanowanie nigdy się nie uruchamia.

Podstawowe skanowanie zdekodowało każdy wariant Quickstart, który nie powiódł się powyżej, a wyjątek pochodzi z wewnątrz IronQR 2026.10.1. W naszym biegu kalibracyjnym pełnej macierzy, każdy plik, którego Auto nie odnalazł, miał logo, a sześć z osmiu było na High lub Highest, dwóch poziomach z największą redundancją do wydawania na logo. W przebiegniętym teście, z płaskim marginesem 10-pikselowym wybranym przez agenta, dwa z ośmiu brakiem Auto nie miały żadnego logo.

Dodać te kontrolę do tej samej recenzji.

  • Kompilacja: wymyślony członek nie przejdzie dotnet build, podobnie jak instrukcja using napisana IronQR, która używa formatowania paczki, podczas gdy namespace to IronQr.
  • Rozmiary: porównaj każdą zapisaną szerokość z żądanym rozmiarem plus oba marginesy z boków. Brak zgodności pokazuje styl, który nigdy nie dotknął wywołania zapisu.
  • Ładunek: dekodować plik na dysku. Verify porównuje tekst z wewnętrzną pamięcią IronQR, więc ścieżka pliku zwraca fałsz, a plik zapisany z niewłaściwym stylem pozostaje niezauważony.

Przewodnik po sumie kontrolnej i tolerancji na awarie omawia odczytywanie uszkodzonych kodów i walidację tego, co wraca. Aby zobaczyć kompletny przebieg zadania IronQR od początku do końca z własnymi kryteriami przejścia, zobacz przewodnik po asystentach kodowania AI.

Co wyprodukowały zapytania w rzeczywistym uruchomieniu?

Wysłaliśmy trzy powyższe prompty do Claude Code w kolejności, w jednej sesji. Plik marki zawierał trzy kampanie, rozmiar plakatu 600 pikseli i rozmiar naklejki 120 pikseli, obok kwadratowego logo i szerokiego znaku słownego. Oddzielna kompilacja Release czystej kopii następnie ponownie uruchomiła macierz i zapisała identyczny CSV, a niezależne dekodowanie każdego zapisanego PNG zgadzało się z każdym wierszem.

  • Podczas pierwszego uruchomienia macierz dopasowała się do 0 z 72 wariantów w obu trybach. Po tym jak Claude Code usunęło blok using na QrImageInput, 55 z 72 pasowało.
  • IronQR odrzuciło 9 wariantów przy zapisie, każdy z manualnym logo. Z 63 zapisanych plików, podstawowe skanowanie odczytało wszystkie 63, a Auto odczytało 55.
  • Dla Quickstart, Claude Code wybrało 300-pikselowy kod z marginesami 10-pikselowymi i logo 50 x 50. Jego 320 x 320 PNG pasowało do URL przy pierwszym odczycie.
  • Subagent nie znalazł żadnego członka IronQR brakującego w IronQr.xml.
  • Każdy prompt pozostawił czystą kompilację Release bez ręcznych edycji, a suma macierzy równa się wynikowi kalibracji.
  • Odpisana odpowiedź zatwierdziła plan trzeciego prompta zamiast dialogu planu, ponieważ sesja była prowadzona nieinteraktywnie.

Wersje, modele, czasy i maszyna testowa dla tego przewodnika i jego odpowiedników znajdują się w wspólnej historii uruchomień.


Rozwiązywanie problemów


Pytania?

W przypadku jakichkolwiek pytań, należy skontaktować się z support@ironsoftware.com

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

Czytaj więcej

Gotowy, aby rozpocząć?

Pobrania z NuGet 82,442Wersja:2026.11właśnie wydane