IronOCR ile Claude Code'u Nasıl Kullanırsınız

Curtis Chau
Curtis Chau
Güncellendi: 9 Ekim 2026

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ıç
NuGetNuGet ile Yükle

PM > Install-Package IronOcr

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

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.
Text

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.



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.MacOs kullanır ve Apple silikon Mac'ler IronOcr.MacOs.ARM kullanı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.
Text

İ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.
Text

Bu isteği çalışır hale getiren iki ayrıntı var.

  1. Adlandırılmış dosyalar: kod tam istediğiniz yere iner.
  2. 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.German 2020.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.AdvancedScan gereklilik 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.
Markdown

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 build baş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.ReadBarCodes varsayı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örevUygunlukNeden
Aranabilir PDF'lerGüçlüMetin katmanı kontrol edilebilir
Birden çok yükleme yolları üzerinde bir okuyucuGüçlüDesen tekrarlar
Gerçek taramalar üzerinde ayarlamaKarışıkTarama hatalarını göremez
Lisanslama ve Linux dağıtımıZayıfAnahtarı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 EtBeklenenOkuGüven
sample-01.pdf3016.693016.6994.84
sample-02.pdf6710.246710.2493.19
sample-03.pdf10599.8410599.8496.17
sample-01.pdf, aranabilir kopya3016.693016.69Yazdırılmadı
Hızlı Başlangıç, altı PNG taramasıAltı satırAltı satır91,62'den 96,16'ya
  • Her istek temiz bir Sürüm oluşturma bıraktı. Hızlı Başlangıç, kendi kendine IronOcr 2026.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

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 6,394,824Sürüm:2026.11yeni çıktı