IronPrint'i Claude Code ile Nasıl Kullanılır?
Bir hastane laboratuvarı, bir hizmetten üç tür belge basar. Örnek etiketleri toplama masasındaki etiket yazıcısına gider, sonuç raporları ofis yazıcısına gider ve kurye beyannameleri sevkiyat odasına gider. Bir yönlendirme dosyası, her belge türü için yazıcıyı adlandırır ve bu dosyadaki tek bir yanlış karakter, hasta sonuçlarını bir başka odaya hata olmadan gönderebilir. Claude Code, Anthropic'in etkileşimli kodlama aracı, dosyaları düzenler ve bir depoda komutlar çalıştırır. Komut satırı aracı olarak, VS Code ve JetBrains editörleri için uzantılar olarak, Claude masaüstü uygulamasında ve claude.ai/code adresinde mevcuttur.
IronPrint, .NET'ten sessizce ya da işletim sistemi diyalogu aracılığıyla PDF ve resim basar. PrintSettings.PrinterName özelliği bir iş için yazıcıyı seçer ve Printer.GetPrinterNames makinede yüklü yazıcıları listeler. Aşağıdaki dört test edilmiş istem Claude Code'un bu laboratuvar için bir yazıcı yönlendirici oluşturmasını sağlıyor ve aralarındaki bölümler her istemin dayandığı IronPrint davranışını kaydeder.
Projeler klasöründe açılan bir terminalde claude başlatın ve ilk istemi göndermeden önce modeli /model opusplan ile değiştirin. Bir yola @ yazmak, o dosyanın içeriğini isteğe dahil eder.
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.
Çıktıda tırnaklar, sonundaki boşluğu görünür hale getirir.
Asgari İş Akışı (5 adım)
- C# yazıcı kütüphanesini NuGet'ten indirin
- Proje klasöründen Claude Code'u açın ve modeli /model ile ayarlayın
- IronPrint'in yazıcı adı kurallarını CLAUDE.md'ye kaydedin, böylece her oturum bunları yükler.
- Yalnızca ayarlı ad, yüklü bir yazıcıyla tam olarak eşleştiğinde bir iş gönderen bir yönlendirici isteyin.
- Yönlendirme raporunu inceleyin, ardından sürümden önce her yönlendirilen yazıcıya bir test sayfası gönderin.
.NET baskı projesinde Claude Code ne yapar?
Ajans, yönlendirme dosyasını okuyan, her ayarlı yazıcı adını yüklü yazıcılarla karşılaştıran ve her belge için bir karar kaydeden bir yönlendirme hizmeti yazar. Claude Code ayrıca programı ve testlerini çalıştırabilir ve rapor ettikleri hataları düzeltebilir. Geliştirici, her belge türüne hangi yazıcının hizmet edeceğine karar verir.
İlk istemde paket adını ve sürümünü belirtin. Slopsquatting olarak bilinen saldırıda, saldırganlar dil modellerinin hayal ettiği isimler altında zararlı paketler kaydeder. Bir ajans kendi başına bir paket adı seçtiğinde bu paketlerden birini yükleyebilir.
Claude Code nasıl kurulur?
Kurulum ve ilk oturum açma, Anthropic'in hızlı başlangıcı talimatlarını takip eder. Oturum açıldığında terminalde claude açılır ve bir istemi yanıtlar.
Claude Code'un çalışabileceği bir proje nasıl kurulur?
İlk istemden önce girdileri depoya koyun. Bu kılavuz için örnek proje, net9.0-windows için bir .NET 9 konsol uygulaması, dört belge türü için bir yönlendirme dosyası ve adları belge türleriyle başlayan yedi PDF'lik bir gelen kutusu barındırır. Bir yol, yüklü bir yazıcının tam adını kullanır. Diğer üçü, yüklü olmayan bir yazıcıyı, farklı bir halde yüklü bir adı ve sonuna boşluk eklenmiş yüklü bir adı kullanır.
Claude Code, bir oturum başladığında CLAUDE.md'yi okur, böylece kuralları sonraki her oturumda geçerli olur. Hızlı Başlangıç paketi ekledikten sonra, ikinci istem o dosyayı yazar ve baskı kodunu inceleyen salt okunur bir alt ajan tanımlar.
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, .claude/agents'i izler ve bir yeniden başlatma olmaksızın yeni eklenen alt ajan tanımını yükler; ancak yalnızca o klasör oturumun başında mevcutsa. Bu nedenle örnek depo, oturum açılmadan önce, içinde boş bir .gitkeep dosyası bulunan klasöre sahiptir. IronPrint'in llms.txt işlev kılavuzlarını, ajans yeteneğini ve diğer belgelerini indeksler.
İlk yazdırma çağrısından önce lisans anahtarını uygulayın. Anahtar olmadan Printer.Print ve Printer.PrintAsync atar ve hiçbir iş sıraya alınmaz. IronPrint Lisans Anahtarları sayfası bir deneme anahtarı sunar ve hem kod atamasını hem de yapılandırma dosyası ayarını gösterir.
Hangi IronPrint yazıcı kuralları CLAUDE.md'ye ait?
Her satırın arkasındaki davranışı IronPrint 2026.10.1 de bir defa lisanslı ve bir defa lisanssız olarak inceledik. Blocu Yazdırma bölümünün altına yapıştırın.
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.
İki özel durum şekli hata işlemesini etkiler. Bir işleyici PrintAsync'den özel durumu kontrol eder, ancak Print'den gelen iç özel durumu kontrol eder. Hiçbiri catch (LicensingException) kullanamaz, çünkü tür herkese açık değildir ve o madde CS0122 ile sondajda başarısız oldu.
IronPrint, uyumsuz bir yazıcı adını reddeder mi?
Yazıcı adı belirtme kılavuzu'na göre, ad karşılaştırması büyük/küçük harf duyarlıdır ve yanlış bir ad ya sessizce başarısız olur ya da bir hata oluşturur. Sondajımız, yüklü bir yazıcıyla eşleşmeyen dört ad altında iki sayfalık bir rapor gönderdi. İsimler, yüklenmemiş bir yazıcı adı, yüklü "Adobe PDF" için "adobe pdf", bir boşlukla takip edilen yüklü ad ve boş bir dizeydi. Dört çağrıdan hiçbiri atmaz ve her iş, test makinesindeki varsayılan sıraya, yani Microsoft Print to PDF'ye gönderilir.
Bu nedenle yönlendirici, baskı metodunu çağırmadan önce her ayarlanmış adı yüklü isimlerle karşılaştırmak zorundadır.
IronPrint bir baskı işini nasıl oluşturur?
IronPrint, her PDF sayfasını sürücüye PrintSettings.Dpi'deki çözünürlükte bir resim olarak gönderir. Microsoft Print to PDF için sondaj işini, her sayfası 1239 x 1754 piksel boyutunda bir resim olan ve metin katmanı bulunmayan iki sayfalık bir A4 PDF üretti, 150 DPI'da görüntülendi. Kılavuzdaki örnek çıktılar, varsayılan 300 DPI'da aynı modeli izler, A4 sayfa başına 2479 x 3508 piksel ile. Bu nedenle, bir PDF yazıcının çıktısının kontrolü, sayfa sayıları ya da görüntüleri karşılaştırmalıdır, çünkü basılı metin aranamaz.
Yazdırmadan işleri incelemek için, test kurulumu, IronPrint'in Windows'ta kullandığı WPF yazdırma çağrısını kancaladı. Kancalama her işi XPS formatında diske yazar ve hiçbir şeyi yönlendirmez, ve kaydedilen sayfa imgeleri, sondaj işindekiyle aynı 1239 x 1754 piksel ölçer. IronPrint, diğer ayarları işin yazdırma biletine yazar. Grayscale açıkken, bilet tek renkli çıktı talep etti. Sayfa imgeleri RGB olarak saklandı ve yalnızca gri pikseller içeriyordu. Biletin kopya sayısı NumberOfCopies'dan geldi ve iş her sayfayı bir kez içeriyordu.
Etiket yolu, bir işin geri düşüşünü gösterir. Giriş, gelen kutusundan 100 x 50 mm boyutunda bir etiket olan specimen-label__S-031.pdf'tir, yönlendirme dosyası LAB-ZEBRA-01'e PaperSize.PrinterDefault ile 300 DPI'da gönderir.
Çıktı
Etiket yolunun ayarları ad kontrolü olmadan gönderildi, bu yüzden iş Microsoft Print to PDF'ye geri düştü. Sonra yazıcı varsayılan kağıt boyutu, o yazıcının A4 sayfasına çözüldü ve etiket, A4 yatay bir sayfada 1179 x 591 piksel boyutunda bir resim oldu. İş, o resmi sayfanın tam genişliğinde 297 x 149 mm'ye ölçeklendirdi.
Etiket S-031 örneği IronPrint, ad kontrolü olmadan işi oluşturdu. Bir A4 yatay sayfa 300 DPI'da, Microsoft Print to PDF'ye yönlendirildi ve bir yazıcı yerine bir dosyaya kaydedildi.
Derlenen IronPrint kodu istemini nasıl oluşturursunuz?
Yönlendiriciyi ve raporunu plan modunda bir istem olarak gönderin, böylece tasarım dosya değişikliklerinden önce kabul edilir. Durum çubuğu plan modunu gösterene kadar Shift+Tab tuşlarına basın, ardından istemi gönderin. opusplan altında, plan Opus'tan gelir ve Sonnet, plan onaylandıktan sonra değişiklikleri yapar.
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/.
İstemin iki bölümü yönlendirmeyi korur.
- Gönder bayrağı:
--sendolmadan, program hiçbir iş göndermez, böylece ajan bir diyalog açan bir makinede yönlendiriciyi çalıştırabilir ve test edebilir. - Denetçi alt ajan: özel bir alt ajan CLAUDE.md'yi yükler, böylece yazıcı adı kuralları incelemesine de uygulanır. Yerleşik ajanlardan, Explore ve Plan CLAUDE.md olmadan başlar.
IronPrint yönlendirme kodu lisans anahtarı olmadan test edilebilir mi?
Evet, eğer testler yazdırma çağrısını değiştirmişse. Yönlendirme dosyasını okuma, yüklü yazıcıları listeme ve PrintSettings oluşturma, hepsi anahtarsız çalışır, bu yüzden her yönlendirme kararı anahtarı olmayan bir yapı sunucusunda test edilebilir.
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.
Oluşturulan IronPrint koduna güvenmeden önce neyi doğrulamalısınız?
Oluşturulan IronPrint kodunu bu kontrollerle gözden geçirin.
- Yapı: IronPrint'in sahip olmadığı bir üye
dotnet build'i derleme hatasıyla durdurur. Gönderilen IronPrint.xml ayrıca içPdfiumUtilssınıfinin bir yöntemini belgeler ve bunu çağıran kod CS0122 ile başarısız olur. - Yönlendirme raporu: ilki gerçek işten önce her kararı yönlendirme dosyası ve yüklü yazıcı listesi ile karşılaştırın.
- Yazıcı başına bir test sayfası: sürümden önce, her cihazda, bir test sayfasının yönlendirme dediği yerde yazdırıldığını doğrulayın.
AI kodlama yardımcıları kılavuzu, sabit geçiş kriterlerine sahip bir tam IronPrint görevini, tekrarlanabilir bir test olarak verir.
Gerçek bir çalıştırmada istemler ne üretti?
Dört istem, gösterilen sırayla tek bir Claude Code oturumunda çalıştı. 3. istemden önce, kurallar bloğu CLAUDE.md'ye yapıştırıldı ve kimse kodu elle düzenlemedi.
- Hızlı Başlatma çıktısı, dört yüklü yazıcının hepsini adlandırdı ve bir yolu yüklü üçünü eksik işaretledi.
- Yönlendirme raporu her biri 7 dosya için bir satır içerdi.
- 2 dosya gönderildi olarak işaretlendi, 2 ad uyuşmazlığı, 2 yüklenmemiş ve 1 yön yok.
- Her karar, yüklü yazıcılara karşı bağımsız kontrolümüzle eşleşti.
- Yakın eşleşme, kurye manifestosu için Adobe PDF ve servise özeti için Microsoft Print to PDF idi.
- Temiz bir Sürüm çalıştırması taze bir kopya içinde aynı raporu üretti.
- Anahtar olmadan, program IsLicensed'ı False olarak rapor etti ve aynı 7 kararı verdi.
- 10'da 10 test, IRONPRINT_LICENSE_KEY değişkeni olmayan bir işlemde geçildi.
- Alt ajan, IronPrint.xml'den eksik olan IronPrint üyesi bulamadı.
- Alt ajan, tam kontrolden sonra bir yazıcı adı atanmış bir yazıcı buldu.
- Yazdırma önbellekleri, çalıştırmadan sonra boştu ve dökümanlarda hiçbir komut --send kullanmadı.
- İki gönderim işinin yakalaması, her biri 1239 x 1754 piksel bir imaja sahip 3 A4 portre sayfasını Adobe PDF sırasına tuttu.
- Her istem, hata veya uyarı olmadan bir Sürüm yapısı bıraktı.
- Dökümanların, oturum dosyalarının ve deponun taranması, lisans anahtarının bir kopyasını bulamadı.
- Bazı adımlar sayfadan farklı çalıştı. Yazılı bir yanıt, oturum başsız çalıştığı için 3. planı onayladı. Test makinesindeki her yazıcı bir Kaydet diyalogu açtığından hiçbir iş yazdırılmadı, bu yüzden iki gönderim işi XPS'e kaydedildi.
Yönlendirme raporundaki ilk gönderim satırı, gelen kutusundan iki sayfalık bir sonuç raporu olan result-report__RPT-4471.pdf idi.
Çıktı
Yakalama aracı, bu satırın ayarlarını yönlendirme raporundan IronPrint'e iletti. Aşağıdaki PDF, değişiklik yapılmadan hem yakalanan sayfaları barındırır.
Sonuç raporu RPT-4471, IronPrint'in çalıştırmanın yönlendirme raporundan gönderme işini oluşturduğu şekilde. Her iki sayfa, Adobe PDF kuyruğu için 150 DPI'da A4 portre olup, yazıcı yerine bir dosyaya kaydedildi.
Cursor'un da bir Plan Modu vardır ve Cursor kılavuzu, 3. talimatını onun içinde gönderir. Codex, ChatGPT Codex kılavuzu gösterildiği gibi, proje kurallarını AGENTS.md'den, CLAUDE.md'nin karşılığı olarak okur. Bu çalıştırmanın Claude Code sürümü, modelleri ve toplam süresi test makinesinin yanında çalıştırma kaydında görünür.
Hata Ayıklama
PrintUI iş parçacığını engellediğinde WPF ve WinForms'da Print() Metodu Askıda Kalır- Web.config içinde ayarlanan bir anahtar uygulandığında web.config Lisans Kurulumu
- Desteklenmeyen Hedef Çerçevelerde
ShowPrintDialogçağrıları için ShowPrintDialog Davranışı
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.