IronBarcode Çalışmalarını Claude Code'a Devretme

Curtis Chau
Curtis Chau
Güncellendi: 21 Eylül 2026

Bir barkod görevinin başarılı olup olmayacağını üç faktör belirler. NuGet paketi BarCode, lisans anahtarı ortamdan gelir ve iş, görüntünün kodu çözülüp yazılan değerle karşılaştırılana kadar bitmiş sayılmaz. Claude Code, bu serideki bilgileri isteminiz yerine depoda tutan araçtır. Her konuşmanın başında CLAUDE.md okur ve bir görev barkod koduna dokunduğunda .claude/skills/ironbarcode/SKILL.md yükler. Bu, IronBarcode'un yayımlanmış skill.md dosyasının yerleştirilmesi için tasarlanan konumdur.

Bu kurallar, onları okuyan model hangisi olursa olsun geçerlidir ve seçtiğiniz model, maliyeti belirleyen en önemli etkendir. /model sonnet seçeneği, etiket hizmeti bağlama ve test setlerini çalıştırma gibi çoğu barkod görevi için yeterlidir. /model opusplan seçeneği, planlama için Opus'u ve uygulama için Sonnet'i kullanır. Bu, kod haritalamanın kritik olduğu karmaşık geçişlerde yararlıdır. Fable 5.1'e yönelik fable takma adı ile basit görevler için haiku takma adı da mevcuttur ve oturum sırasında modeller arasında geçiş yapabilirsiniz.

Bir paket tüm işi kapsar, bu da bir ajanla insanla olduğundan daha fazla önem taşır. 1D ve 2D yazma, tek bir görüntüden okunan birkaç barkod ve çoklu iş parçacıklı okumalar aynı API'den gelir. Bu yüzden ajan, onayınızı gerektiren ikinci bir kütüphane eklemek için görev ortasında durmaz. Gidiş-dönüşü görevin kendisine dahil edin, çünkü GeneratedBarcode.Verify az önce yazdığı görüntünün kodunu çözer ve değeri karşılaştırır.

Seçilen katman hem oluşturulan kodu hem de maliyeti etkiler. Aynı istemi farklı modellere vermek, sınıf adları, seçenek yerleşimleri ve test yapıları dahil olmak üzere farklı uygulamalar getirir. Tutarlı bir çıktı için kodlamayı, piksel boyutlarını ve başarılı sayılacak şeyi sabitleyin. Sonrasında modelin geri kalanını seçmesine izin verin.

Hızlı Başlangıç
NuGetNuGet ile Yükle

PM > Install-Package BarCode

Yukarıdaki komutu NuGet Paket Yöneticisi Konsolunda çalıştırarak veya NuGet Paket Yöneticisinde arama yaparak IronBarcode'u yükleyin.

.NET projenizde bir oturum başlatın ve uygulama ayrıntıları yerine gereksinimlere odaklanarak istediğiniz barkodu belirtin.

Bring in the BarCode package, then write a console app that decodes every PNG
in @TestData/inbox/ at once rather than one at a time. Use BarcodeReader.ReadAsync with
ExpectMultipleBarcodes enabled and MaxParallelThreads set to the core count.
Take the license from IRONBARCODE_LICENSE_KEY. Print each file name with the
values found in it, and print how long the whole batch took.
Text

Claude Code, geriye kalan adımları tamamlar: paketi ekler, asenkron okuma bağlantılarını kurar, projeyi derler, derleme hatalarını çözer ve sonuçları raporlar. Kod değişikliklerini ve ölçtüğü süreyi inceleyin. asenkron ve çoklu iş parçacıklı kılavuz, ulaşması gereken seçenekleri kapsar.

Belirtilmemiş tüm ayrıntılar otomatik olarak belirlenir. Basit örnekler için bu kabul edilebilir, çünkü en son paket ve varsayılan ayarlar kullanılır. Üretim işleri için aşağıdaki üç kısıtlamayı isteminizde belirleyin:

  1. Sürümü belirtin: Ajanın tek bir API yüzeyine karşı kodlaması için IronBarcode sürümünü adlandırın.
  2. Bağımlılıkları sınırlayın: Eklenen herhangi bir barkod kütüphanesinin bulunmadığından emin olmak için yalnızca BarCode paketine izin verin.
  3. Ajanın durmasına izin verin: Belgelenmiş API'leri kullanmasını ve kesin olmayan bir durumda size danışmasını isteyin.


Barkod işlerinin hangi parçalarını devretmelisiniz?

Claude Code esas itibariyle rutin geliştirme görevleriyle ilgilenir. Kodları okur, yazar ve yeniden düzenler, derlemeleri çalıştırır ve test döngüsünü yürüttüğünüz yüzeyden yönetir. Barkod oluşturma ve tarama, özel bir kurulum olmadan döngüye dahil olur.

Barkod görevlerinde Claude Code, tekrarlayan işleri yönetir: etiket hizmetlerini yazma, tarama uç noktaları oluşturma, gereken formatlarda test görüntüleri oluşturma ve geri okuma. Geçersiz bir EAN-13 kontrol basamağı gibi sorunları tespit eder ve düzeltir, gerektiğinde yeniden derler ve hatalardan sonra yeniden dener. Barkod gereksinimlerini siz belirtir ve ortaya çıkan kod değişikliklerini incelersiniz.

Barkod kütüphanesini seçmekten siz sorumlu olmaya devam edersiniz. Birini belirtmezseniz, ajan, eğitim verilerinde en sık karşılaştığı kütüphaneyi varsayılan olarak seçer, bu da dört soruna yol açabilir:

  • Sembol boyutu ve kontrol basamakları: Küçülen bir sembol, eksik bir sessiz bölge veya hatalı bir basamak tarama sırasında doğru görünüp başarısız olabilir. IronBarcode, yazarken her semboloji için değerleri doğrular.
  • Token hacmi faturalandırmayı belirler: Kendi çözücüsünü oluşturan bir ajan, her işlemde token öderken, çoklu iş parçacıklı okumalar, hız ayarları ve görüntü filtreleri zaten ayarlanmış ve belgelenmiş olarak gelir.
  • Özel işlem hatları doğrulama eksikliğine sahiptir: Büyük veri setleri veya yayımlanmış kıyaslamalara karşı test edilmezler, belgelenmiş bir API ise tekrarlanan bir gidiş-dönüş testi ile test edilmiştir.
  • Paket adı bir güvenlik kontrolü olarak işlev görür: dotnet add package IronBarcode IronBarcode'u yüklemez ve kötü niyetli aktörler tarafından benzer isimler kaydedilmiştir.

Ajanın asla tahmin etmesine gerek kalmaması için isteminizde BarCode belirtin.

Paketin adını bir kez belirttikten sonra, sonraki görevler bir kütüphane seçimine ihtiyaç duymaz.

Tertemiz bir kurulumdan ilk barkod isteminize geçişteki adımlar nelerdir?

Uygulamayı yükleyin, Claude hesabınızla oturum açın ve başlamaya hazırsınız. Anthropic'in Claude Code genel bakışı aracın detaylı bir açıklamasını sunar. hızlı başlangıç kılavuzu macOS, Windows ve Linux üzerinde kurulum ve ilk oturumunuzu kapsar. Ayrıca bir IDE tercih edenler için VS Code ve JetBrains eklentilerine ayrılmış sayfalar vardır. Anthropic'in YouTube kanalı da başlangıç oturumunun adım adım videolarını sunar.

claude başlatıldığında ve yanıt verdiğinde geri dönün.

Claude Code'un çalışabileceği bir proje nasıl kurulur?

Standart bir .NET projesi oluşturun ve ajanla açmadan önce IronBarcode'u ekleyin. Projenin önceden başarıyla derlendiğini doğrulamak, kafa karışıklığını ortadan kaldırır ve ajanı hangi barkod kütüphanesini ya da benzer adlandırılmış paketi kullanacağı konusunda tahminde bulunmaktan alıkoyar.

dotnet new console -n LabelScanDemo
cd LabelScanDemo
dotnet add package BarCode --version 2026.9.2
claude
SHELL

Son komut, o anki klasörde bir oturum açar, ajanın okuma ve düzenlemelerini o dizinle sınırlar. Anthropic'in belgeleri bu yaklaşımı önerir. CLI'yi başlatmadan önce proje dizinine geçin. Terminal, IDE eklentileri, masaüstü uygulaması ve web dahil tüm arabirimler aynı motoru kullanır. Sonuç olarak, CLAUDE.md dosyası, proje ayarları ve proje için yapılandırılan MCP sunucuları oturumlar boyunca tutarlıdır.

İki ek ayrıntı ileriye dönük faydalı olacaktır:

  1. CLAUDE.md: Her oturumun başında Claude Code'un yüklediği talimat dosyası, hedef çerçeveyi, BarCode paketini ve yalnızca belgelenmiş API'lere izin verildiği kuralını adlandırır.
  2. IronBarcode'un dokümantasyon dizini: llms.txt, ajanların ayrıştırabileceği gerçek doküman URL'lerini listeler ve skill.md, yaygın hatalar için doğrulanmış tarifler ve çözümler ekler.

Claude Code, depodaki .claude/skills/<name>/SKILL.md yeteneklerini okur. IronBarcode'un dosyasını .claude/skills/ironbarcode/SKILL.md olarak kaydedin ve depoya commit edin. Yalnızca ön bilgideki description bağlamda kalır ve ilgili bir görev ortaya çıktığında Claude, gövdeyi yükler. Bu yaklaşım, barkod çalışması başlayana kadar ek yükü en aza indirir. Daha da hassaslaştırmak için, ajanın beceriyi yalnızca ilgili dosyalara eriştiğinde yüklemesi için Services/** gibi bir paths glob deseni ekleyin.

Her iki dosya da yerinde olduğunda, ajan belleğine güvenmek yerine belgeleri referans alır. Gerekli dosyayı tek bir istem oluşturabilir.

Write me a Barcodes section for CLAUDE.md and append it to the file, creating
the file if there isn't one. Cover these rules, in your own words, as
instructions to yourself in future sessions:

- IronBarcode (NuGet package BarCode, namespace IronBarCode) handles all
  barcode work here. No other barcode package gets added.
- Consult https://ironsoftware.com/barcode/csharp/llms.txt first. Anything not
  on a page it lists does not go in the file. Load
  https://ironsoftware.com/barcode/csharp/skill.md as a skill file.
- The license key comes from IRONBARCODE_LICENSE_KEY. Never inline it.
- A barcode task ends when the saved image has been read back and the decoded
  string matches the input, not when the code compiles.

Then show me the section you added and tell me whether this repository also has
an AGENTS.md you should be reading alongside it.
Text

İlk çalıştırmadan önce lisanslamayı ayarlayın, çünkü IronBarcode, geliştirme için tanınan ek süre sona erdiğinde filigran eklemek yerine LicensingException fırlatır. Başlangıç sırasında, barkodla ilgili herhangi bir işlemden önce anahtarı ortam değişkeninden alın. IronBarcode Lisans Anahtarları belgeleri bir anahtarı nasıl alacağınızı ve uygulayacağınızı açıklar.

Derlenen IronBarcode kodu için nasıl bir istem oluşturursunuz?

Ajanın aksi takdirde çıkarım yapabileceği üç unsuru belirtin: semboloji, değerlerin kaynağı ve başarı kriterleri.

İstemleri gereksinim tanımları olarak yazın.

Press Shift+Tab first so this runs in plan mode, and show me the plan before anything touches disk. Then create Services/LabelService.cs with a method that turns a tracking number into PNG bytes. The symbol is Code 128, the image is 400 wide by 120 tall, and the human-readable number sits underneath it. Then create Services/ScanService.cs with an async method that reads a Code 128 barcode from an image path and returns the value, or null when nothing is found. Add a console check that writes three tracking numbers, reads each back, and prints whether they match. Use only methods documented at ironsoftware.com/barcode/csharp. If unsure of a method name, stop and ask.
Text

Bu istemin etkili olmasını sağlayan üç unsur vardır:

  1. Dosya yolları: İstem bunları adlandırır, böylece ajanın icat ettiği yerine gezinilebilir bir proje yapısı elde edersiniz.
  2. Her iki tarafta da semboloji: yazıcı ve okuyucu ikisi de Code 128 kullanır, bu nedenle okuyucunun formatı tahmin etmesine gerek kalmaz.
  3. Gidiş-dönüş olarak tanımlanan tamamlanma: ajan, yazılan değerin okunan değerle eşleştiğini doğrular, bu da barkodun görünümünü doğrulamaktan daha üstündür.
İpuçları: Bir istenç etkili olduğunda, Claude Code'a kısıtlamalarını CLAUDE.md içine kopyalamasını belirtin. Sonraki oturumlar bu kısıtlamaları otomatik olarak yükleyecektir.

Sonuç kısa olmalıdır. BarcodeWriter.CreateBarcode yöntemini BarcodeEncoding.Code128 ile kullanır; ardından ResizeTo, AddBarcodeValueTextBelowBarcode ve SetMargins ile etiketin boyutunu ayarlar, değerini yazdırır ve sessiz bölge ekler. ToPngBinaryData baytları üretir ve BarcodeReader.ReadAsync, ExpectBarcodeTypes Code 128 olarak ayarlandığında bu baytları okur. Oluşturulan dosyalar yerine gerçek taramalarla çalışırken, Speed, CropArea ve görüntü filtreleri gibi seçenekler çok daha önemlidir. Barkod Okuyucu öğreticisi onları kapsar.

Lütfen dikkat: Her zaman kodla birlikte bir dokümantasyon bağlantısı isteyin. Bir ajan kullandığı bir API için geçerli bir referans sağlayamazsa, yapı başarısız olana kadar bunu bilirsiniz.

Claude Code, MCP aracılığıyla IronBarcode'a bağlanabilir mi?

Claude Code, dış araçlarla açık bir standart olan Model Context Protocol (MCP) aracılığıyla bütünleşir. Bir MCP sunucusu, modelin eğitimde görmediği araçları, veritabanlarını ve API'leri ortaya çıkarabilir ve tek bir CLI komutu bir sunucu ekler, MCP referansı bunu gösterir.

IronBarcode'un bir sunucuya ihtiyacı yoktur. Entegrasyonu, üç URL olarak yayımlanmış belgeleridir. llms.txt belgeleri indeksler. skill.md dosyası doğrulanmış tarifler ve yaygın hatalar saklar. API referansı, sürümdeki her sınıfı ve üyeyi listeler. Bunları okumak, ajana hatırlanmış bir API yerine mevcut gerçekler verir ki bu, MCP sunucularının genellikle çözdüğü aynı güncelliğini yitirmiş yöntem sorunudur. Çalıştırılacak bir işlem, korunacak bir yapılandırma ve belgeler güncellendiğinde bir yeniden başlatma yoktur. Ajan, oturumu sırasında sayfaları getirir.

Bu üç kaynağı proje bağlamına ekleyin, ya yapıştırarak ya da CLAUDE.md'dan referans alarak. Oturumdaki her istem bunları kullanabilir.

Üretilen barkod koduna güvenmeden önce neyi doğrulamalısınız?

Her API adını ve her barkodu her seferinde doğrulayın. Her biri bir sonrakinden daha az maliyetli olan dört adımı sırayla izleyin:

  • Derleme başarılı: Değişikliklerin tek bir satırını bile okumadan önce dotnet build çalıştırın; çünkü uydurulmuş bir üye burada saniyeler içinde hataya neden olur.
  • Her üye var: Tanımadığınız her sınıf ve yöntem için API referansı kapsamında arayın ve Databar ve DataBar tek bir harfin büyük/küçük yazımıyla farklılaştığı kodlama enumlarını bir kez daha inceleyin.
  • Her barkod geri taranır: GeneratedBarcode.Verify bunu tek bir çağrıda çözer ve kaydedilen dosyayı BarcodeReader ile okumak, diske ulaşan aynı şeyi kanıtlar.
  • Hata yönetimi yerinde: oluşturulan kod, genellikle BarcodeReader.Read her zaman bir barkod bulduğunu varsayar ve LicensingException, bozuk bir dosya için IronBarCodeFileException, şifrelenmiş bir PDF için IronBarCodePdfPasswordException ve eksik bir yolun attığı düz System.IO.FileNotFoundException'ı göz ardı eder.

Yanlış bir kontrol basamağı mükemmel bir şekilde derlenir ve hiçbir şey bulamayan bir okuma, bir istisna atmadan boş bir BarcodeResults koleksiyonu döndürür. Takip eden bir istemde bu işlemi talep edin ve ajanı hata yönetimi kılavuzuna yönlendirin.

BarcodeScanner.DecodeImageFile() yazan bir ajan, IronBarcode'un sahip olmadığı makul bir yöntem adı üretmiştir. Derleyici bunu anında reddeder, bu yüzden erken aşamada ve sık sık derleyin.

Bilmeniz gereken pratik sınırlar nelerdir?

Bazı barkod görevleri ajanlara diğerlerinden daha uygundur.

GörevUygunlukNeden
Barkod oluşturmaGüçlüGeri okuyarak doğrulandı
Gidiş-dönüş testleriGüçlüBaşarı, dizelerin eşleşmesiyle belirlenir
Hizmet entegrasyonuGüçlüTekrarlanan desen
Gerçek taramaları ayarlamaKarışıkGöremediği kusurlar
Lisanslama ve dağıtımZayıfAnahtarınız, platformunuz

Bir görev bir barkodu geri okuyarak denetlenebiliyorsa, bir ajan bunu iyi yapar. Görülmemiş resimlere ya da belirli bir dağıtım hedefiyle ilgiliyse, daha fazla kontrol gerektirir. Claude Code'a doğrudan barkod oluşturma, hizmet entegrasyonu ve gidiş-dönüş testlerini devredin. Lisanslama, platform paketleri veya gerçek taramalar üzerinde ayarlama için, isteğe örnek resimler veya bir dokümantasyon bağlantısı ekleyin.

Hangi kararlar size kalır?

Claude Code, hizmetleri ve test verilerini oluşturur ve gerektiğinde yineleyerek devam eder. Kütüphaneyi seçmek ve API adlarını doğrulamak sizin sorumluluğunuzda kalır.

Oturumu kapatmadan önce alınan kararları CLAUDE.md içinde belgeleyin. Böylece bir sonraki oturum, bu oturumun sona erdiği yerden başlar. Boş bir projeden başlayıp belirlenmiş başarı ölçütlerine ulaşan bir görev, AI kodlama yardımcıları ve ajanlar kılavuzu altında, ChatGPT Codex, GitHub Copilot, Cursor ve Google Antigravity kılavuzları ile yazılmıştır.


Sorun Giderme

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.

Daha Fazla Oku

Başlamaya Hazır mısınız?

NuGet İndirmeleri 2,564,559Sürüm:2026.11yeni çıktı