IronOCR ile Claude Code'u Nasıl Kullanırsınız
AI ajanını taranmış faturalar üzerinden toplamları çıkarmak için kullanmak basit görünüyor, ta ki eğik veya noktalı bir tarama, bir 7'yi 1'e çevirene kadar ve hesaplar ödenmeden kimse fark edene kadar. Anthropic'in kodlama ajanı Claude Code, terminalde, VS Code ve JetBrains'de, masaüstü uygulaması olarak ve tarayıcıda çalışır. Kod okur, dosyaları düzenler ve komutları çalıştırır, bu da bir sayfadan okunan bir değer uyuşmadığında kodun değişmesi gereken OCR işleri için uygundur.
IronOCR, ayarlı bir Tesseract motorunu yerel olarak çalıştırır, bu nedenle OCR işleme herhangi bir veriyi harici hizmetlere göndermez. Claude Code, okuduklarını modele gönderir, kodunuzun yazdırdığı metin de dahil, bu nedenle gerçek tedarikçi faturaları yerine örnek sayfalara karşı geliştirin. Claude Code okuyucuyu yazabilir, bilinen değerlerle bu sayfaları oluşturabilir ve bir görevin tamamlandığını rapor etmeden önce her sonucu bunlarla karşılaştırabilir.
Modeller tarz olarak farklılık gösterir. Aynı isteğe verilen iki model, farklı sınıf isimleri ve yapıları seçebilir ve yalnızca belirttiğiniz şeyde anlaşabilir. Aşağıda gösterilen istek bölümünde olduğu gibi, önemli olan ayrıntıları belirtin ve modelin geri kalanını belirlemesine izin verin.
Hızlı BaşlangıçClaude Code'u bir .NET projesinde başlatın, /model sonnet ile Sonnet'e geçin ve bu isteği gönderin.
Add IronOCR (the IronOcr NuGet package) to this project, then read every PNG in
@TestData/inbox/ and print one row per file giving the file name, the overall
confidence, and the first line of text. Read the license key from the
IRONOCR_LICENSE_KEY environment variable.
Bir istek ayrıntıları açık bırakırsa, Claude Code bunları belirler. Hedef çerçevenizi tutar ve kendi adlarını seçer. Hızlı bir test için bu iyi. Üretim kodu için, kodun bilinen bir API'yi hedef alması için istekte IronOCR sürümünü belirtin.
Asgari İş Akışı (5 adım)
- C# OCR kütüphanesini NuGet'ten indirin
- Claude Code'u proje klasöründen çalıştırın, böylece mevcut kodu görebilir
- Projenin OCR kurallarını gelecekteki oturumlar için
CLAUDE.mdiçine yazın - Her istekte hedef dosyaları adlandırın ve plan modunda daha büyük değişiklikleri gönderin
- Her değişiklikten sonra derleyin ve yazdırılan sonuçları gözden geçirin
Bir .NET OCR projesinde Claude Code ne yapar?
Bir OCR projesinde, Claude Code fatura okuyucusunu yazar ve her sayfayı okur. Toplam yanlış olduğunda veya bir sayfa metin döndürmediğinde, okumayı ayarlar ve tekrar dener. Belgeleri tanımlarsınız ve sonuçları gözden geçirirsiniz.
- Tarama temizleme dahili: IronOCR'un giriş nesnesi zaten düzeltme filtreleri sağlar, bu nedenle ajan kendi görüntü işleme yazmak yerine birini uygular.
- Bakımlı motor ayarlama işini azaltır: el ile yapılandırılmış bir Tesseract kurulumu güvenmeden önce test edilmelidir. AI kod yardımcıları rehberi, makinenizde çalıştırabileceğiniz bir testi içerir.
- Her platformun kendine özgü paketi vardır: Intel Mac'ler
IronOcr.MacOskullanır ve Apple silikon Mac'lerIronOcr.MacOs.ARMkullanır. Paketi tahmin eden bir ajan, bir saldırganın modelin icat ettiği bir ad altında yayınladığı benzer bir paketi yükleyebilir, bu tür bir saldırı slopsquatting olarak bilinir.
Claude Code nasıl kurulur?
Anthropic'in hızlı başlangıcı ile Claude Code'u yükleyin ve oturum açın. Başladığında ve yanıt verdiğinde, ortam hazırdır.
Claude Code'un çalışabileceği bir proje nasıl kurulur?
Ajanı başlatmadan önce bir konsol projesi oluşturun. Her oturum açıldığında Claude Code CLAUDE.md okur ve bir istek dosyayı oluşturur.
Create CLAUDE.md at the project root with an OCR section stating that this
project uses IronOCR (NuGet package IronOcr, or IronOcr.Linux for Linux and
Docker, namespace IronOcr) for all OCR work, that you must read
https://ironsoftware.com/ocr/csharp/llms.txt before writing OCR code and use only
APIs documented there, that https://ironsoftware.com/ocr/csharp/skill.md should
be loaded if the tooling supports skill files, that the license key is read from
the IRONOCR_LICENSE_KEY environment variable and never inlined, that every OCR
change must be tested on sample pages with known values, and that no other OCR
engine or cloud OCR service may be added.
İlk okumadan önce lisansı belirleyin. Geçerli bir anahtar olmadan, IronOCR'un Read yöntemi çıktıyı işaretlemez veya bozmaz. Bir LicensingException fırlatır. Bu tür genel değildir, bu nedenle kodun başlangıçta License.IsLicensed kontrol etmesini, istisnayı ad ile yakalamak yerine kontrol ettirin. IronOCR Lisans Anahtarları sayfası, anahtar almayı ve saklamayı ele alır.
Derlenebilir IronOCR kodu için nasıl istek yaparsınız?
Terminalde, plan modu açık olana kadar Shift+Tab'a basın, sonra bu isteği gönderin.
Create Services/InvoiceReader.cs with a method that takes the path of a scanned PDF, reads it with IronTesseract, finds the line that starts with Total due, and returns the amount as a decimal together with that line's confidence, or null if the line is missing. Create Services/SearchablePdf.cs with a method that writes a searchable copy of a scanned PDF. Add a console check that reads three sample invoices with known totals and prints expected total, total read, confidence, and match for each. Use only methods documented at ironsoftware.com/ocr/csharp. If unsure of a method name, stop and ask.
Bu isteği çalışır hale getiren iki ayrıntı var.
- Adlandırılmış dosyalar: kod tam istediğiniz yere iner.
- Güven: Düşük güvenle doğru okunan bir değer, bir sonraki taramanın yanlış okunabileceği konusunda uyarır ve tablo bunu görünür kılar.
Ortaya çıkan kod kısadır. Motoru oluşturur, kullanma bildirimi içindeki PDF'yi yükler, Read çağırır, sonucun satırlarında toplamı arar ve arama yapılabilir kopyayı SaveAsSearchablePdf ile yazar. taranmış PDF giriş rehberi ve arama yapılabilir PDF rehberi her iki adımı da kapsar.
Bir kısayola dikkat edin. IronOCR'un beceri dosyası, tek satırlık bir dönüşüm için IronTesseract.ConvertToSearchablePdf sunar ve Claude Code her iki testimizde de önce ona yöneldi. Sadece görüntü taramalarında IronOCR 2026.9.4 ve 2026.10.2'de 'PDF belgesi herhangi bir görüntü içermiyor' hatasını fırlatır. Claude Code hatayı okudu, yukarıdaki yaklaşıma geçti ve başarılı oldu.
Hangi IronOCR ayarları CLAUDE.md içinde yer alır?
Orada üç IronOCR kararını belirleyin.
- Diller:
IronOcr.Languages.German2020.11.2'de son bulurken motor her ay yayınlanır. IronOCR'un birden çok dil rehberi, ek dillerin hız ve performansı etkileyebileceği konusunda uyarır. - Filtreler: Projemizde, aşağıdaki kuralda adı geçen iki filtreyi $9,924.31 toplamının küçük bir kırpık çevresindeteki tek satır okumasına eklemek, onu yalnız bir noktaya indirdi.
- Okuma yöntemi: Fotoğraf yöntemi, bizim projemizdeki temel IronOCR 2026.9.4 paketinde ek bir kurulum olmadan çalıştı, ancak fotoğraf okuma rehberi hala
IronOcr.Extensions.AdvancedScangereklilik olarak listeler.
## OCR settings
- Languages: English (built in) and German (IronOcr.Languages.German).
Language packs keep their own versions. Never align them with IronOcr.
- A LanguagePackException names the missing package. Install that package
instead of catching the exception.
- Add secondary languages in order of how often they appear.
- Apply Deskew() and DeNoise() to the whole page before any crop.
- Scans use IronTesseract.Read. Photographs of documents use ReadPhoto,
which supports fewer languages than Read.
- Make searchable copies with Read followed by SaveAsSearchablePdf.
Claude Code IronOCR ile MCP üzerinden bağlanabilir mi?
Bir komutla bir MCP sunucusu ekleyebilir, MCP referansı açıklar, ancak IronOCR bir tanesine ihtiyaç duymaz. dokümantasyon dizini ve projenin kural dosyasından bağlantılı beceri dosyası ajan'a mevcut API, reçeteler ve düzeltmeler için ev sahibi veya yeniden başlatma gerektirmeksizin verir.
Oluşturulmuş OCR koduna güvenmeden önce neyi doğrulamalısınız?
Her değişiklikten sonra bu üç kontrolü sırayla tamamlayın.
- Oluşturma geçer: icat edilmiş bir üye
dotnet buildbaşarısız olur, bu yüzden önce çalıştırın. - Varsayılanlar iş için uygun: kodun güvendiği ayarları kontrol edin.
Configuration.ReadBarCodesvarsayılan olarak kapalıdır. - Başarısızlıklar ele alınır: başarısızlık yollarını adlarıyla isteyin. hata ayıklama rehberi, günlüğe kaydetmeyi ve IronOCR'un yükselttiği istisnaları kapsar.
Hangi OCR görevleri ajana uygundur?
| Görev | Uygunluk | Neden |
|---|---|---|
| Aranabilir PDF'ler | Güçlü | Metin katmanı kontrol edilebilir |
| Birden çok yükleme yolları üzerinde bir okuyucu | Güçlü | Desen tekrarlar |
| Gerçek taramalar üzerinde ayarlama | Karışık | Tarama hatalarını göremez |
| Lisanslama ve Linux dağıtımı | Zayıf | Anahtarınıza ve sunucularınıza bağlıdır |
Karışık ve zayıf satırlar için, ajana gerçek örnek taramalar veya dağıtım detaylarınızı verin ve sonucu yakından inceleyin.
Gerçek bir çalıştırmada istemler ne üretti?
Bu kılavuzdaki üç istek, altı PNG fatura taraması ve üç yalnızca görüntü taramalı PDF içeren yeni bir .NET 9 konsol uygulamasına karşı sırasıyla Claude Code'a gönderildi. Oturumdan sonra, bağımsız bir Sürüm oluşturma ve çalıştırma aşağıdaki her rakamı yeniden üretti.
| Kontrol Et | Beklenen | Oku | Güven |
|---|---|---|---|
| sample-01.pdf | 3016.69 | 3016.69 | 94.84 |
| sample-02.pdf | 6710.24 | 6710.24 | 93.19 |
| sample-03.pdf | 10599.84 | 10599.84 | 96.17 |
| sample-01.pdf, aranabilir kopya | 3016.69 | 3016.69 | Yazdırılmadı |
| Hızlı Başlangıç, altı PNG taraması | Altı satır | Altı satır | 91,62'den 96,16'ya |
- Her istek temiz bir Sürüm oluşturma bıraktı. Hızlı Başlangıç, kendi kendine
IronOcr2026.10.2 seçti ve bir derleme hatasına çarptı, ki Claude Code el edinimleri olmadan düzeltti. - Bir adım sayfadan farklı çalıştı. Yazılmış bir yanıt üçüncü isteğin planını onayladı, plan diyalogunun yerine.
Bu kılavuzun arkasındaki sürümleri, modelleri, süreleri ve test makinesini çalıştırma kaydı listeler.
Hata Ayıklama
- Lisans Anahtarını IronOCR'a Uygulayın eğer operasyon başarılı olursa ve ilk okuma daha sonra bir lisanslama istisnası fırlatırsa
- OCR Doğruluğunu İyileştirin eğer karşılaştırma tablosundaki bir satır filtre değişikliğinden sonra hala başarısız olursa
- Birden Çok Dili Okuyun eğer ajan projenin hiçbir zaman yüklemediği bir dili ayarlarsa
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.