IronQR ile Claude Code Nasıl Kullanılır
Pazarlama ekibi, her kampanya QR kodunun markanın lacivert rengini kullanmasını, logonun merkezde bulunmasını ve hem poster hem de çıkartma boyutlarında mevcut olmasını gerektiriyor. Ancak, her ek stil seçimi tarama güvenilirliğini azaltabilir. Örneğin, bir logo modülleri kapatabilir, açık bir ön plan kontrastı azaltabilir ve daha küçük baskı boyutları piksel yoğunluğunu azaltır. Bir QR kodu ekranda doğru görünebilir, ancak gerçek dünyada yine de başarısız olabilir. Claude Code, Anthropic'in kodlama ajanı, terminaller, VS Code, JetBrains, masaüstü uygulamaları ve web üzerinden çalışır. Herhangi bir ortamda, projeyi okur, dosyaları düzenler ve komutları çalıştırır, böylece stilize kodlar oluşturabilir, kaydedilen dosyaları çözebilir ve yük korunduğu sürece stili ayarlayabilir.
IronQR, aynı .NET süreci içinde QR kodları oluşturur ve okur, bu nedenle ajan her değişiklikten sonra tarama yapabilir. Kütüphane otomatik olarak bazı okunamaz tasarımları reddeder. Çok fazla alan kaplayan elle ayarlanmış bir logo veya beyaz arka plana çok yakın olan bir ön renk, kaydederken bir IronQrException tetikler. Diğer stil seçenekleri başarıyla kaydedilebilir, ancak yine de daha sonra okunamayabilir. En güvenilir yaklaşım, stilize edilmiş varyantlar matrisini test etmek ve kaydedilen her PNG'yi çözmektir. Bu kılavuz, bu süreç için Claude Code'u nasıl yapılandıracağınızı, üç test edilmiş yönlendirmeyle ve her birinin dayandığı IronQR davranışlarını açıklar.
Tek bir model ayarı, tüm üç yönlendirmeyi destekler. opusplan takma adı plan modunda Opus'u ve aksi takdirde Sonnet'i kullanır, bu da sadece matris yapısının planlama gerektirdiği bir oturuma uygundur.
Proje klasörünü bir terminalde açın, Claude Code'u başlatın ve /model opusplan komutunu çalıştırın. Bir dosya yolunun önüne @ yazıp Claude Code'a o dosyayı teslim edin, ardından isteği gönderin.
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.
Bu kodun en doğrudan sürümü başarısız olabilir. Sondajlarımızda, otomatik boyutlandırılmış bir logo ile varsayılan hata düzeltme seviyesinde kaydedilen bahar satışı kodu, hatasız olarak kaydedildi, ardından boş olarak okundu veya okuyucunun varsayılan tarama modunda ObjectDisposedException attı. 500 piksellik bir kodda manuel 100 piksellik bir logo doğru olarak okundu.
Önce basılı genişliği kontrol edin. Sondajımızda, boyut ayarlanmadan verilen stil seçenekleri, bu URL için 49 piksellik bir görüntü üretti.
Asgari İş Akışı (5 adım)
- C# QR kod kütüphanesini NuGet'ten indir
- Projede Claude Code'u başlatın ve
/modelile bir model seçin - Her oturumun bunlarla başlamasını sağlamak için IronQR stili kurallarını
CLAUDE.mdiçine kaydedin - Kod düzeltme seviyesi ve logo boyutundan renkler ve pikselliği kadar her varyantı tanımlayın
- Hem tarama modlarında kaydedilen her PNG'yi çözümleyin
Claude Code bir .NET QR kodu projesinde ne yapar?
Ajan, oluşturucuyu yazar, marka dosyasını okur, her varyant için bir PNG kaydeder, her dosyayı çözer ve hangi tasarımların tutulduğunu rapor eder. Kampanyanın hangi varyantlara ihtiyacı olduğunu söylersiniz ve geri dönen tabloyu gözden geçirirsiniz.
Markalı kodlar bu kontrolü otomatik hale getirmeye değer kılar çünkü logo boyutu, düzeltme seviyesi ve piksel büyüklüğü etkileşir. Test edilen çalışmada, IronQR, bir kampanya için 600 piksellik kodun genişliğinin %30'unda manuel bir logo kaydetti ve 120 pikselde aynı oranı reddetti, başka bir kampanya ise tersini gösterdi.
İlk yönlendirmeden itibaren IronQR sadece QR kütüphanesi olarak belirleyin. Bir paket adını tahmin eden bir ajan, o tahmini yakalamak için yayınlanmış bir benzerini yükleyebilir ki buna slopsquatting saldırısı denir.
Claude Code nasıl kurulur?
Anthropic'in hızlı başlangıcı ile Claude Code'u yükleyin ve oturum açın. Bir terminalde başladığında ve yanıt verdiğinde, hazırdır.
Claude Code'un çalışabileceği bir proje nasıl kurulur?
İlk yönlendirmeden önce depoyu hazırlayın. İnşa eden bir .NET 9 konsol projesi, her kampanyanın URL'leri ve renkleri olan bir Brand/campaigns.json dosyası ve logo dosyaları, ajanın çalışması için gerçek girdiler sağlar. Klasörden Claude Code'u başlatın, böylece oturum ona değişken olur.
Claude Code her oturumun başında CLAUDE.md okur, bu da onu bir yönlendirmeyi aşan kurallar için bir yer yapar. Hızlı başlangıç paketi ekledikten sonra, ikinci bir yönlendirme dosyayı yazar.
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.
XML yolu önem taşır çünkü stil ve okuma türleri, IronQR.Slim paketinde bulunur, bu da IronQR 'a bağlıdır, bu yüzden üye listesi önbelleğin o klasöründe durur. Kılavuzlar üye listesi ile sınırlı olmayanlar için, IronQR, ajanlar için llms.txt adresinde bir indeks yayınlar.
İlk renderdan önce lisansı halledin. Anahtar olmadığında, hem QrWriter.Write hem de QrReader.Read "Üretim Lisansı Gerekli" mesajı veren bir LicensingException fırlatır ve geriye dönüp su işaretiyle deneme çıktısı yoktur. Bu istisna türü genel değildir, bu yüzden programın, adıyla istisnayı yakalamak yerine IRONQR_LICENSE_KEY ile anahtarı ayarladıktan sonra License.IsLicensed kontrol etmesini sağlayın. IronQR Lisans Anahtarları sayfası, anahtar alma ve IronQR'ın onu okuduğu yerleri kapsar.
Hangi IronQR ayarları CLAUDE.md içinde yer alır?
Her satır, bir prob inşa ederek veya lisanslı bir anahtarla birini çalıştırarak IronQR 2026.10.1 ile kontrol edildi. Bloku QR kodları bölümünün altına yapıştırın.
## 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.
Siyah modüller siyah bir arka plan üzerine hatasız kaydedildi ve hiçbir tarama modu dosyayı çözümleyemedi.
Bir QR kodunun boyutunu, kenar boşluklarını ve renklerini nasıl kontrol edersiniz?
Bir QrStyleOptions nesnesi her görsel seçim tutar. Save onu uygular ve SaveAs ile diske yazdığınız bir bitmap döndürür. Hata düzeltme seviyesi, başka bir yerde, QrOptions içinde yer alan tek ayardır çünkü kodlanmış sembolü değiştirir.
Dimensions piksel cinsinden kod boyutunu ayarlar ve Margins dört yandaki sessiz alanı belirlerken, MarginTop ve diğer taraflar her bir tarafı ayarlar. Color koyu modülleri boyar ve BackgroundColor ışık alanını ve kenar boşluklarını boyar. Logo bitmap, genişlik, yükseklik ve köşe yarıçapı ile bir QrLogo alır.
Sondajımızda, 50 piksel üst ve alt kenar boşluğuna sahip 400 piksellik kod ve 20 piksel yan kenar boşlukları 440 x 500 olarak kaydedildi. yeniden boyutlandırma kılavuzu, kenar boşlukları kılavuzu ve renkler kılavuzu her ayarı kendi başına gösterir.
Save argümansız çağrıldığında 250 x 250 görüntü döner. Bu boyut içsel varsayılandır.Her hata düzeltme seviyesinde bir logo ne kadar büyük olabilir?
Düzeltme yüzdelerinin önerdiğinden daha küçüktür. Bu rakamlar, Reed-Solomon kodlamasının yeniden inşa edebileceği kod kelimelerini sayar ve merkezi bir logo sadece bir hasar kaynağıdır. Bahar satışı URL'sini 600 pikselde sade bir kare logoyla oluşturduk, IronQR otomatik boyutlandırdı ve ardından IronQR kaydetmeyi reddedene kadar manuel boyutu birer birer artırdık.
| Düzey | Belgelendirilmiş kurtarma | Otomatik logo (genişlik, alan) | En büyük manuel logo (genişlik, alan) |
|---|---|---|---|
| Düşük | 7% | 20%, 4.0% | 23%, 5.3% |
| Orta | 15% | 30%, 9.0% | 31%, 9.6% |
| Yüksek | 25% | 32.5%, 10.6% | 39%, 15.2% |
| En Yüksek | 30% | 32%, 10.2% | 44%, 19.4% |
2026.10.1 derlemesinde, otomatik boyutlandırma, kod genişliğinin yarısından bir yirminciye kadar olan kısa bir kesir listesi dener ve okuyucusunun çözümlediği ilkini tutar. Bu liste, Yüksek ve En Yüksek'in genişliğin üçte birine yakın olmasının nedenini açıklar. Manuel bir boyut daha yukarıya gider, alan bağlamında belgelenmiş kurtarmanın yaklaşık %60 ile %75'i arasına, ancak IronQR bunu kendi okuyucusuyla tam çözünürlükte kontrol eder. İkinci bir tarama modu, bu kontrolün geçtiği yerde başarısız olabilir.
Rakamlar yükten bağıdır. Daha uzun bir URL, farklı sınırlara sahip daha yoğun bir sembol üretir, bu yüzden tabloyu bir değiş tokuş şekli olarak kabul edin ve matris kendi kampanyalarınızı ölçsün.
Her stilize IronQR varyantını tek bir yönlendirmede nasıl test edersiniz?
Tüm tabloyu bir yönlendirmede isteyin ve plan modu önce tasarımı ayarlasın. Durum çubuğu plan modunu gösterene kadar Shift+Tab tuşuna basın, ardından yönlendirmeyi gönderin.
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.
Her cümle, sonuçların olabileceğinden daha iyi göründüğü bir yolu kapatır.
- Her kombinasyon adlandırılmıştır: üç kampanya, dört seviye, üç logo modu ve iki boyut 72 varyant oluşturur, bu yüzden
out/scan-matrix.csviçindeki eksik bir satır görünür. - Kaydetme hataları satırlardır: kaydetme reddedilmesi bir sonuçtur ve bu satırlar logo boyutu sınırının nerede olduğunu gösterir.
- Her okuma için taze bir okuyucu: başarısız bir okuma bir sonrakini etkileyemez.
- İkinci bir ajan API'yi kontrol eder: genel amaçlı alt ajan
CLAUDE.mdyükler, yerleşik Explore ve Plan alt ajanları atlar, bu yüzden kontrol projenin kurallarını görür.
Oluşturulan IronQR koduna güvenmeden önce neyi doğrulamalısınız?
QrScanMode.Auto kendi tespit modeli hiçbir şey bulmadığında yalnızca temel taramaya geri döner ve numaralandırmanın kendi belgeleri önce tespit modeli, sonra "hiçbiri bulunmazsa temel bir brute force okuma" olarak tanımlar. Model kodu bulduğunda ancak çözemediğinde, Otomatik boş bir sonuç döner ve temel tarama asla çalışmaz.
Temel tarama, yukarıda başarısız olan her Hızlı Başlangıç varyantını çözdü ve istisna IronQR 2026.10.1 içinden geliyor. Tam matrisin kalibrasyon çalışmamızda, Otomatik'in kaçırdığı her dosyada bir logo vardı ve sekizden altısı Yüksek veya En Yüksek'te idi, logoya harcayacak en fazla yedekliğe sahip iki seviye. Test edilen çalışmada, ajanın seçtiği 10 piksellik düz kenar boşluğu ile sekiz Otomatik kaybın ikisi hiç logo içermiyordu.
Aynı incelemeye bu kontrolleri ekleyin.
- Yapı: yaratılmış bir üye
dotnet buildbaşarısız olur ve aynı zamandaIronQRyazılmış yönlendirme ifadesi, paketin büyük/küçük harf kullanımı kullanırken ad alanıIronQr. - Boyutlar: kaydedilen her genişliği, istenen boyutlu ve her iki yan kenar boşluğuyla karşılaştırın. Bir uyumsuzluk, asla kaydetme çağrısına ulaşmayan bir stili gösterir.
- Yük: diskteki dosyayı çözümleyin.
Verifymetni IronQR'ın kendi bellek içi oluşturmayla karşılaştırır, bu yüzden bir dosya yolu yanlış döner ve yanlış stil ile yazılmış bir dosya fark edilmez.
checksum ve hata tolerans kılavuzu, hasarlı kodları okuma ve geri dönenleri doğrulama konularını kapsar. Kendi geçiş kriterleriyle sonuna kadar eksiksiz bir IronQR görev çalıştırması için, AI kodlama asistanları kılavuzuna bakın.
Gerçek bir çalıştırmada istemler ne üretti?
Yukarıdaki üç yönlendirmeyi Claude Code'a sırayla, bir oturumda gönderdik. Marka dosyası üç kampanya, 600 piksellik poster boyutu ve 120 piksellik çıkartma boyutu, dikdörtgen bir logo ve geniş bir kelime işareti içeriyordu. Ardından ayrı bir Sürüm yapım temiz kopyası matrisi tekrar çalıştırdı ve aynı CSV'yi yazdı ve her kaydedilen PNG'nin bağımsız çözümü her satırla uyumluydu.
- İlk çalıştırmada matris her iki modda da 72 varyantın 0'ını eşleştirdi. Claude Code
QrImageInputüzerindeki using bloğunu kaldırdıktan sonra 72'nin 55'i eşleşti. - IronQR, kaydederken her biri manuel logolu olan 9 varyantı reddetti. Kaydettiği 63 dosyadan, temel tarama tüm 63 dosyayı çözdü ve Otomatik 55'ini çözdü.
- Hızlı başlangıç için, Claude Code 10 piksellik kenar boşluklarına ve 50 x 50 logolu 300 piksellik bir kod seçti. Onun 320 x 320 PNG'si ilk okumada URL'ye eşleşti.
- Alt ajan,
IronQr.xml'den hiçbir IronQR üyesi bulamadı. - Her yönlendirme, el ile düzenleme olmadan temiz bir Sürüm yapısı bıraktı ve matris toplamları kalibrasyon çalışmasıyla eşleşti.
- Yazılı bir yanıt üçüncü yönlendirme planını onayladı çünkü oturum etkileşimli olmayan bir şekilde çalıştırıldı.
Bu kılavuz ve kardeşleri için sürümler, modeller, zamanlamalar ve test makinesi paylaşılan çalıştırma kaydı içinde yer alır.
Hata Ayıklama
- Oluşturma başarılı olursa ve ilk yazma lisans istisnası fırlatırsa IronQR'da bir Lisans Anahtarı Uygulayın
- Manuel boyutlandırılmış bir logo kaydetme IronQrException fırlatırsa QR Kodlarına Logo Ekle
- Varyantının logosu için daha fazla yedekliğe ihtiyaç duyması durumunda QR Kod Hata Düzeltme Düzeylerini Ayarlayın
Sorular?
Herhangi bir sorunuz varsa, support@ironsoftware.com adresinden bize ulaşın
Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.