Comment utiliser IronOCR avec Claude Code
Utiliser un agent IA pour extraire les totaux de factures scannées semble simple jusqu'à ce qu'un scan incliné ou tacheté transforme un 7 en 1 et que personne ne remarque l'erreur avant le service des comptes fournisseurs. Claude Code, l'agent de codage d'Anthropic, s'exécute dans le terminal, dans VS Code et JetBrains, en tant qu'application de bureau et dans le navigateur. Il lit le code, édite les fichiers et exécute des commandes, ce qui convient aux travaux d'OCR où le code doit changer chaque fois qu'une valeur lue à partir d'une page ne correspond pas.
IronOCR exécute un moteur Tesseract ajusté localement, donc le traitement OCR n'envoie aucune donnée à des services externes. Claude Code envoie ce qu'il lit au modèle, y compris le texte que votre code imprime, donc développez avec des pages d'exemple plutôt que de vraies factures fournisseurs. Claude Code peut écrire le lecteur, générer ces pages avec des valeurs connues et comparer chaque résultat avec elles avant de signaler l'achèvement d'une tâche.
Les modèles varient dans leur style. Étant donné la même invite, deux modèles peuvent choisir des noms de classes et des structures différentes et être d'accord seulement sur ce que vous avez spécifié. Indiquez les détails qui comptent, comme le montre la section d'invite ci-dessous, et laissez le modèle décider du reste.
Démarrage rapideDémarrez Claude Code dans un projet .NET, passez à Sonnet avec /model sonnet, et envoyez cette invite.
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.
Si une invite laisse des détails ouverts, Claude Code les décide. Il garde votre framework cible et choisit ses propres noms. Cela convient pour un test rapide. Pour du code en production, mentionnez la version IronOCR dans l'invite afin que le code cible une API connue.
Flux de travail minimal (5 étapes)
- Téléchargez la bibliothèque C# OCR depuis NuGet
- Exécutez Claude Code depuis le dossier du projet pour qu'il puisse voir le code actuel
- Écrivez les règles OCR du projet dans
CLAUDE.mdpour les sessions futures - Nommez les fichiers cibles dans chaque invite et envoyez des modifications plus importantes en mode plan
- Construisez après chaque modification et revoyez les résultats imprimés
Que fait Claude Code dans un projet OCR .NET ?
Dans un projet OCR, Claude Code écrit le lecteur de factures et lit chaque page. Quand un total est faux ou qu'une page ne renvoie aucun texte, il ajuste la lecture et réessaye. Vous décrivez les documents et examinez les résultats.
- Le nettoyage de scan est intégré : l'objet d'entrée d'IronOCR fournit déjà des filtres de correction, donc l'agent en applique un plutôt que d'écrire son propre traitement d'image.
- Un moteur maintenu évite les réglages manuels : une configuration manuelle de Tesseract nécessite des tests avant que vous puissiez lui faire confiance. Le guide des assistants de codage IA inclut un test que vous pouvez exécuter sur votre machine.
- Chaque plateforme a son propre paquet : les Macs Intel utilisent
IronOcr.MacOset les Macs Apple silicon utilisentIronOcr.MacOs.ARM. Un agent qui devine le paquet peut installer un sosie publié par un attaquant sous un nom que les modèles ont tendance à inventer, une attaque connue sous le nom de slopsquatting.
Comment configurer Claude Code ?
Installez Claude Code avec le guide rapide d'Anthropic et connectez-vous. Quand il démarre et répond, l'environnement est prêt.
Comment configurer un projet dans lequel Claude Code peut travailler ?
Créez un projet de console avant de lancer l'agent. Claude Code lit CLAUDE.md à l'ouverture de chaque session, et une invite crée le fichier.
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.
Réglez les licences avant la première lecture. Sans clé valide, la méthode Read d'IronOCR ne marque pas en filigrane ou ne dégrade pas la sortie. Elle lance une LicensingException. Ce type n'est pas public, donc faites vérifier au code License.IsLicensed au démarrage au lieu d'intercepter l'exception par son nom. La page IronOCR License Keys couvre l'obtention et le stockage d'une clé.
Comment formuler une invite pour qu'un code IronOCR compile ?
Dans le terminal, appuyez sur Shift+Tab jusqu'à ce que le mode plan soit activé, puis envoyez cette invite.
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.
Deux détails rendent cette invite efficace.
- Fichiers nommés : le code atterrit exactement là où vous le souhaitez.
- Confiance : une valeur correcte lue avec une faible confiance avertit que le prochain scan pourrait être mal interprété, et le tableau le rend visible.
Le code résultant est court. Il crée le moteur, charge le PDF à l'intérieur d'une déclaration using, appelle Read, recherche dans les lignes du résultat le total, et écrit la copie consultable avec SaveAsSearchablePdf. Le guide d'entrée PDF scanné et le guide des PDF consultables couvrent les deux étapes.
Attention à un raccourci. Le fichier de compétences d'IronOCR offre IronTesseract.ConvertToSearchablePdf pour une conversion en une ligne, et Claude Code l'a utilisé en premier dans nos deux tests. Sur des scans d'images uniquement, il jette "PDF document does not contain any images" dans IronOCR 2026.9.4 et 2026.10.2. Claude Code a lu l'erreur, est passé à l'approche ci-dessus et a réussi.
Quels paramètres IronOCR appartiennent à CLAUDE.md ?
Réglez trois décisions IronOCR ici.
- Langues :
IronOcr.Languages.Germans'arrête à 2020.11.2 tandis que le moteur est mis à jour mensuellement. Le guide des langues multiples d'IronOCR avertit que des langues supplémentaires peuvent affecter la vitesse et les performances. - Filtres : dans notre test, ajouter les deux filtres nommés dans la règle ci-dessous à une lecture en une ligne d'une petite découpe autour du total de 9 924,31 $ l’a réduit à un seul point.
- La méthode de lecture : la méthode de photo a fonctionné dans le paquet de base IronOCR 2026.9.4 pendant notre analyse, sans installation supplémentaire, bien que le guide de lecture photo liste toujours
IronOcr.Extensions.AdvancedScancomme une exigence.
## 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 peut-il se connecter à IronOCR via MCP ?
Claude Code peut ajouter un serveur MCP avec une seule commande, comme l'explique la référence MCP, mais IronOCR n'en a pas besoin. L' index de documentation et le fichier de compétences lié depuis le fichier de règles du projet donnent à l'agent l'API actuelle, les recettes et les corrections sans rien héberger ou redémarrer.
Que devriez-vous vérifier avant de faire confiance au code OCR généré ?
Complétez ces trois vérifications dans l'ordre après chaque changement.
- La compilation passe : un membre inventé échoue
dotnet build, donc exécutez-le d'abord. - Les valeurs par défaut conviennent au travail : vérifiez les paramètres sur lesquels le code repose.
Configuration.ReadBarCodesest désactivé par défaut. - Les échecs sont gérés : demandez par nom les chemins d'échec. Le guide de débogage couvre la journalisation et les exceptions soulevées par IronOCR.
Quelles tâches d'OCR conviennent à un agent ?
| Tâches | Convient | Pourquoi |
|---|---|---|
| PDF consultables | Fort | La couche de texte peut être vérifiée |
| Un lecteur pour plusieurs chemins de téléchargement | Fort | Le motif se répète |
| Ajustement sur des scans réels | Mixte | Il ne peut pas voir les défauts de vos scans |
| Licences et déploiement Linux | Faible | Dépend de votre clé et de vos serveurs |
Pour les lignes mélangées et faibles, fournissez à l'agent des scans d'échantillons réels ou les détails de votre déploiement et revoyez le résultat avec plus d'attention.
Qu'est-ce que les messages ont produit lors d'une réelle exécution ?
Les trois invitations de ce guide ont été envoyées à Claude Code dans l'ordre, contre une nouvelle application console .NET 9 contenant six scans de factures PNG et trois PDF scannés d'images uniquement. Après la session, une build Release indépendante et un exécutable ont reproduit chaque chiffre ci-dessous.
| Vérification | Attendu | Lecture | Confiance |
|---|---|---|---|
| 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, copie consultable | 3016.69 | 3016.69 | Non imprimé |
| Démarrage rapide, six scans PNG | Six lignes | Six lignes | 91,62 à 96,16 |
- Chaque invitation a laissé une construction Release propre. Le Démarrage rapide a choisi
IronOcr2026.10.2 par lui-même et a rencontré une erreur de compilation qu'il a corrigée sans modifications manuelles. - Une étape s'est déroulée différemment de celle décrite sur la page. Une réponse typée a approuvé le plan du troisième ordre de marche, à la place de la boîte de dialogue du plan.
Le enregistrement de l'exécution répertorie les versions, les modèles, les temps et la machine de test derrière ce guide et les autres de l'ensemble.
Dépannage
- Appliquez une clé de licence dans IronOCR si la construction réussit et que la première lecture lance ensuite une exception de licence
- Améliorez la précision de l'OCR si une ligne du tableau de comparaison échoue encore après un changement de filtre
- Lire plusieurs langues si l'agent définit une langue que le projet n'a jamais installée
Des questions ?
Si vous avez des questions, contactez support@ironsoftware.com
Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.