Wie man IronOCR mit Claude Code verwendet
Die Verwendung eines KI-Agenten zur Erfassung von Summen aus gescannten Rechnungen wirkt einfach, bis ein schiefer oder gesprenkelter Scan eine 7 in eine 1 verwandelt und dies niemand bemerkt, bevor es die Kreditorenbuchhaltung tut. Claude Code, Anthropics Codierungsagent, läuft im Terminal, in VS Code und JetBrains, als Desktop-App und im Browser. Es liest Code, bearbeitet Dateien und führt Befehle aus, was sich für OCR-Arbeiten eignet, bei denen der Code immer dann geändert werden muss, wenn ein aus einer Seite gelesener Wert nicht übereinstimmt.
IronOCR führt lokal eine abgestimmte Tesseract-Engine aus, sodass die OCR-Verarbeitung keine Daten an externe Dienste sendet. Claude Code sendet das Gelesene an das Modell, inklusive des Textes, den Ihr Code ausgibt, daher entwickeln Sie anhand von Musterseiten und nicht nach echten Lieferantenrechnungen. Claude Code kann den Leser schreiben, diese Seiten mit bekannten Werten generieren und jedes Ergebnis mit diesen vergleichen, bevor es eine Aufgabe als abgeschlossen meldet.
Modelle variieren im Stil. Bei gleichen Eingaben können zwei Modelle unterschiedliche Klassennamen und Strukturen wählen und sich nur auf das verständigen, was Sie spezifiziert haben. Nennen Sie die Details, die wichtig sind, wie im untenstehenden Eingabebereich gezeigt, und überlassen Sie dem Modell den Rest.
SchnellstartStarten Sie Claude Code in einem .NET-Projekt, wechseln Sie zu Sonnet mit /model sonnet und senden Sie diese Eingabe.
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.
Wenn eine Eingabe Details offen lässt, entscheidet Claude Code diese. Es behält Ihr Ziel-Framework bei und wählt eigene Namen. Das ist für einen schnellen Test in Ordnung. Für Produktionscode geben Sie die IronOCR-Version in der Eingabe an, damit sich der Code auf eine bekannte API bezieht.
Minimaler Arbeitsablauf (5 Schritte)
- Laden Sie die C# OCR-Bibliothek von NuGet herunter
- Führen Sie Claude Code aus dem Projektordner aus, damit es den aktuellen Code sehen kann.
- Schreiben Sie die OCR-Regeln des Projekts in
CLAUDE.mdfür zukünftige Sitzungen. - Benennen Sie die Zielfestdateien in jeder Eingabe und senden Sie größere Änderungen im Planmodus.
- Kompilieren Sie nach jeder Änderung und überprüfen Sie die gedruckten Ergebnisse.
Was macht Claude Code in einem .NET OCR-Projekt?
In einem OCR-Projekt schreibt Claude Code den Rechnungsleser und liest jede Seite. Wenn eine Summe falsch ist oder eine Seite keinen Text zurückgibt, passt es den Lesevorgang an und versucht es erneut. Sie beschreiben die Dokumente und überprüfen die Ergebnisse.
- Scan-Bereinigung ist integriert: IronOCRs Eingabeobjekt bietet bereits Korrekturfilter, sodass der Agent lieber einen anwendet, als eine eigene Bildverarbeitung zu schreiben.
- Eine gewartete Engine spart Abstimmungsarbeit: Eine manuell konfigurierte Tesseract-Einrichtung muss getestet werden, bevor Sie ihr vertrauen können. Der Leitfaden für KI-Coding-Assistenten enthält einen Test, den Sie auf Ihrem Rechner ausführen können.
- Jede Plattform hat ihr eigenes Paket: Intel Macs verwenden
IronOcr.MacOsund Apple Silicon Macs verwendenIronOcr.MacOs.ARM. Ein Agent, der das Paket errät, kann ein ähnlich aussehendes installieren, das ein Angreifer unter einem Namen veröffentlicht hat, den Modelle typischerweise erfinden, ein Angriff bekannt als slopsquatting.
Wie richten Sie Claude Code ein?
Installieren Sie Claude Code mit Anthropics Quickstart und melden Sie sich an. Wenn es startet und antwortet, ist die Umgebung bereit.
Wie richten Sie ein Projekt ein, in dem Claude Code arbeiten kann?
Erstellen Sie ein Konsolenprojekt, bevor Sie den Agenten starten. Claude Code liest CLAUDE.md, wenn jede Sitzung geöffnet wird, und eine Eingabe erstellt die Datei.
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.
Regeln Sie die Lizenzierung vor dem ersten Lesen. Ohne einen gültigen Schlüssel versieht die Methode Read von IronOCR keine Ausgaben mit einem Wasserzeichen oder verschlechtert sie. Es wirft eine LicensingException. Dieser Typ ist nicht öffentlich, lassen Sie daher den Code beim Start License.IsLicensed überprüfen, anstatt die Ausnahme nach Namen abzufangen. Die Seite IronOCR License Keys behandelt das Erhalten und Speichern eines Schlüssels.
Wie fordern Sie IronOCR-Code an, der kompiliert?
Im Terminal drücken Sie Shift+Tab, bis der Planmodus aktiviert ist, und senden dann diese Eingabe.
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.
Zwei Details machen diese Eingabe funktionsfähig.
- Benannte Dateien: Der Code landet genau dort, wo Sie ihn haben möchten.
- Zuverlässigkeit: Ein korrekt gelesener Wert bei niedriger Zuverlässigkeit warnt, dass der nächste Scan falsch gelesen werden könnte, und die Tabelle macht das sichtbar.
Der resultierende Code ist kurz. Er erstellt die Engine, lädt das PDF in einer using-Deklaration, ruft Read auf, durchsucht die Zeilen des Ergebnisses nach der Gesamtsumme und schreibt die durchsuchbare Kopie mit SaveAsSearchablePdf. Der Leitfaden für gescannte PDF-Eingaben und der Leitfaden für durchsuchbare PDFs decken beide Schritte ab.
Achten Sie auf eine Abkürzung. IronOCRs Skill-Datei bietet IronTesseract.ConvertToSearchablePdf für eine Ein-Zeilen-Konvertierung, und Claude Code hat es zuerst in beiden unserer Tests verwendet. Bei nur bildhaften Scans wirft es "PDF-Dokument enthält keine Bilder" in IronOCR 2026.9.4 und 2026.10.2 gleichermaßen. Claude Code hat den Fehler gelesen, auf den oben genannten Ansatz gewechselt und war erfolgreich.
Welche IronOCR-Einstellungen gehören in CLAUDE.md?
Klärung von drei IronOCR-Entscheidungen dort.
- Sprachen:
IronOcr.Languages.Germanbleibt bei 2020.11.2 stehen, während die Engine monatliche Veröffentlichungen hat. Der Leitfaden für mehrere Sprachen von IronOCR warnt, dass zusätzliche Sprachen Geschwindigkeit und Leistung beeinflussen können. - Filter: In unserer Untersuchung führte das Hinzufügen der beiden im untenstehenden Regel genannten Filter zu einem Ein-Zeilen-Lesevorgang eines kleinen Ausschnitts rund um die $9,924.31-Summe, dass diese zu einem einsamen Punkt reduziert wurde.
- Die Lese-Methode: Die Fotomethode lief im Basispaket IronOCR 2026.9.4 während unserer Untersuchung ohne zusätzliche Installation, obwohl der Leitfaden zum Fotolesen
IronOcr.Extensions.AdvancedScannoch als Anforderung auflistet.
## 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.
Kann Claude Code über MCP eine Verbindung zu IronOCR herstellen?
Claude Code kann mit einem Befehl einen MCP-Server hinzufügen, wie die MCP-Referenz erklärt, aber IronOCR benötigt keinen. Das Dokumentationsverzeichnis und die vom Regelwerk des Projekts verlinkte Skill-Datei geben dem Agenten die aktuelle API, Rezepte und Korrekturen, ohne dass etwas gehostet oder neu gestartet werden muss.
Was sollten Sie überprüfen, bevor Sie generierten OCR-Code anvertrauen?
Führen Sie diese drei Prüfungen in der Reihenfolge nach jeder Änderung durch.
- Der Build wird bestanden: Ein erfundener Member scheitert bei
dotnet build, also führen Sie ihn zuerst aus. - Die Standards passen zur Aufgabe: Überprüfen Sie die Einstellungen, auf die sich der Code verlässt.
Configuration.ReadBarCodesist standardmäßig deaktiviert. - Fehler werden behandelt: Fragen Sie nach den Fehlerpfaden nach Namen. Der Fehlerbehebungsleitfaden behandelt das Protokollieren und die von IronOCR ausgelösten Ausnahmen.
Welche OCR-Aufgaben eignen sich für einen Agenten?
| Aufgabe | Pass | Warum |
|---|---|---|
| Durchsuchbare PDFs | Stark | Die Textebene kann überprüft werden |
| Ein Leser über mehrere Upload-Pfade | Stark | Das Muster wiederholt sich |
| Feinabstimmung mit realen Scans | Gemischt | Es kann nicht die Mängel Ihrer Scans sehen |
| Lizenzierung und Linux-Bereitstellung | Schwach | Abhängig von Ihrem Schlüssel und den Servern |
Für die gemischten und schwachen Reihen geben Sie dem Agenten echte Beispiels Scans oder Ihre Bereitstellungsdetails und prüfen Sie das Ergebnis genauer.
Was haben die Aufforderungen in einem realen Lauf erzeugt?
Die drei Eingaben in diesem Leitfaden gingen der Reihe nach an Claude Code, gegen eine neue .NET 9-Konsolenanwendung mit sechs PNG-Rechnungs-Scans und drei nur bildhaften gescannten PDFs. Nach der Sitzung reproduzierte ein unabhängiger Release-Build und -Lauf jede Abbildung unten.
| Überprüfen | Erwartet | Lesen | Zuverlässigkeit |
|---|---|---|---|
| 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, durchsuchbare Kopie | 3016.69 | 3016.69 | Nicht gedruckt |
| Schnellstart, sechs PNG-Scans | Sechs Zeilen | Sechs Zeilen | 91,62 bis 96,16 |
- Jede Eingabe hinterließ einen sauberen Release-Build. Der Schnellstart wählte
IronOcr2026.10.2 alleine und stieß auf einen Kompilierungsfehler, den Claude Code ohne manuelle Änderungen behob. - Ein Schritt lief anders als die Seite. Eine typisierte Antwort genehmigte den Plan der dritten Eingabe, anstelle des Plan-Dialogs.
Das Laufprotokoll listet die Versionen, Modelle, Zeiten und die Prüfmaschine hinter diesem Leitfaden und den anderen im Satz auf.
Fehlerbehebung
- Wenden Sie einen Lizenzschlüssel in IronOCR an, wenn der Build erfolgreich ist und der erste Lesevorgang dann eine Lizenzierungs-Ausnahme wirft.
- Verbessern Sie die OCR-Genauigkeit wenn eine Reihe in der Vergleichstabelle nach einer Filteränderung noch scheitert.
- Lesen Sie mehrere Sprachen, wenn der Agent eine Sprache setzt, die das Projekt nie installiert hat.
Fragen?
Wenn Sie Fragen haben, wenden Sie sich an support@ironsoftware.com.
Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.