Cómo usar IronOCR con Claude Code

Curtis Chau
Curtis Chau
Actualizado: 9 de octubre de 2026

Usar un agente de inteligencia artificial para extraer totales de facturas escaneadas parece simple hasta que un escaneo sesgado o salpicado convierte un 7 en un 1 y nadie lo nota antes de que lo haga cuentas por pagar. Claude Code, el agente de codificación de Anthropic, se ejecuta en la terminal, en VS Code y JetBrains, como aplicación de escritorio y en el navegador. Lee código, edita archivos y ejecuta comandos, lo que se adapta al trabajo de OCR donde el código debe cambiar siempre que un valor leído de una página no coincida.

IronOCR ejecuta un motor Tesseract ajustado localmente, por lo que el procesamiento OCR no envía datos a servicios externos. Claude Code sí envía lo que lee al modelo, incluido el texto que tu código imprime, por lo que desarrolla contra páginas de muestra en lugar de facturas reales de proveedores. Claude Code puede escribir el lector, generar esas páginas con valores conocidos y comparar cada resultado con ellas antes de informar que una tarea está hecha.

Los modelos varían en estilo. Dado el mismo prompt, dos modelos pueden elegir nombres de clase y estructuras diferentes y estar de acuerdo solo en lo que especificaste. Indica los detalles que importan, como muestra la sección de prompt a continuación, y deja que el modelo decida el resto.

Inicio rápido
NuGetInstalar con NuGet

PM > Install-Package IronOcr

Instale IronOCR ejecutando el comando arriba en la Consola del Administrador de Paquetes NuGet, o busque el paquete en el Administrador de Paquetes NuGet.

Inicia Claude Code en un proyecto .NET, cambia a Sonnet con /model sonnet y envía este prompt.

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

Si un prompt deja detalles abiertos, Claude Code los decide. Mantiene tu marco objetivo y elige sus propios nombres. Está bien para una prueba rápida. Para el código de producción, indica la versión de IronOCR en el prompt para que el código apunte a una API conocida.



¿Qué hace Claude Code en un proyecto OCR .NET?

En un proyecto OCR, Claude Code escribe el lector de facturas y lee cada página. Cuando un total es incorrecto o una página no devuelve texto, ajusta la lectura y lo intenta nuevamente. Describe los documentos y revisa los resultados.

  • Limpieza de escaneo incorporada: El objeto de entrada de IronOCR ya proporciona filtros de corrección, por lo que el agente aplica uno en lugar de escribir su propio procesamiento de imágenes.
  • Un motor mantenido ahorra trabajo de ajuste: una configuración de Tesseract configurada a mano necesita pruebas antes de que puedas confiar en ella. La guía de asistentes de codificación de AI incluye una prueba que puedes ejecutar en tu máquina.
  • Cada plataforma tiene su propio paquete: Mac con Intel use IronOcr.MacOs y Mac con silicio de Apple use IronOcr.MacOs.ARM. Un agente que adivina el paquete puede instalar un imitador que un atacante publicó bajo un nombre que los modelos tienden a inventar, un ataque conocido como slopsquatting.

¿Cómo configuras Claude Code?

Instala Claude Code con el inicio rápido de Anthropic y accede. Cuando comienza y responde, el entorno está listo.

¿Cómo configuras un proyecto en el que Claude Code pueda trabajar?

Crea un proyecto de consola antes de iniciar el agente. Claude Code lee CLAUDE.md cuando se abre cada sesión, y un prompt crea el archivo.

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

Resuelve la licencia antes de la primera lectura. Sin una clave válida, el método Read de IronOCR no marca con agua ni degrada la salida. Arroja una LicensingException. Ese tipo no es público, así que haz que el código verifique License.IsLicensed al inicio en lugar de capturar la excepción por nombre. La página de Claves de licencia de IronOCR cubre cómo obtener y almacenar una clave.

¿Cómo solicitáis que el código de IronOCR compile?

En la terminal, presiona Shift+Tab hasta que el modo plan esté activado, luego envía este prompt.

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

Dos detalles hacen que este prompt funcione.

  1. Archivos nombrados: el código aterriza exactamente donde quieres.
  2. Confianza: un valor correcto leído con baja confianza advierte que el próximo escaneo puede ser malinterpretado, y la tabla lo hace visible.

El código resultante es corto. Crea el motor, carga el PDF dentro de una declaración using, llama a Read, busca en las líneas del resultado el total y escribe la copia buscable con SaveAsSearchablePdf. La guía de entrada de PDF escaneado y la guía de PDF buscable cubren ambos pasos.

Observa un atajo. El archivo de habilidades de IronOCR ofrece IronTesseract.ConvertToSearchablePdf para una conversión de una línea, y Claude Code lo usó primero en nuestras dos pruebas. En escaneos de solo imagen arroja 'El documento PDF no contiene imágenes' en versiones de IronOCR 2026.9.4 y 2026.10.2 por igual. Claude Code leyó el error, cambió a la estrategia anterior y tuvo éxito.

¿Qué configuraciones de IronOCR pertenecen a CLAUDE.md?

Resuelve tres decisiones de IronOCR allí.

  • Idiomas: IronOcr.Languages.German se detiene en 2020.11.2 mientras que las versiones del motor se publican mensualmente. La guía de múltiples idiomas de IronOCR advierte que los idiomas adicionales pueden afectar la velocidad y el rendimiento.
  • Filtros: en nuestro trabajo, agregar los dos filtros nombrados en la regla a continuación a una lectura de una sola línea de un pequeño recorte alrededor del total de $9,924.31 lo redujo a un solo punto.
  • El método de lectura: el método de foto se ejecutó en el paquete base de IronOCR 2026.9.4 durante nuestra prueba, sin instalación adicional, aunque la guía para leer fotos aún enumera IronOcr.Extensions.AdvancedScan como requisito.
## 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

¿Puede Claude Code conectarse a IronOCR a través de MCP?

Claude Code puede agregar un servidor MCP con un comando, como explica la referencia de MCP, pero IronOCR no necesita uno. El índice de documentación y el archivo de habilidades vinculados desde el archivo de reglas del proyecto proporcionan al agente la API actual, recetas y correcciones sin nada que alojar o reiniciar.

¿Qué deberías verificar antes de confiar en el código OCR generado?

Completa estos tres chequeos en orden después de cada cambio.

  • La compilación pasa: un miembro inventado falla dotnet build, así que ejecútalo primero.
  • Los valores predeterminados se adaptan al trabajo: verifica la configuración de la que depende el código. Configuration.ReadBarCodes está desactivado por defecto.
  • Se gestionan los fallos: solicita las rutas de falla por nombre. La guía de depuración cubre el registro y las excepciones que genera IronOCR.

¿Qué tareas de OCR son adecuadas para un agente?

TareaCostoPor qué
PDFs buscablesFuerteLa capa de texto puede ser verificada
Un lector en varios caminos de cargaFuerteEl patrón se repite
Ajuste en escaneos realesMixtoNo puede ver los defectos de tus escaneos
Licenciamiento e implementación en LinuxDébilDepende de tu clave y servidores

Para las filas mixtas y débiles, proporciona al agente escaneos de muestra reales o los detalles de tu implementación y revisa el resultado más de cerca.

¿Qué produjeron los prompts en una ejecución real?

Los tres prompts de esta guía se enviaron a Claude Code en orden, contra una nueva aplicación de consola .NET 9 que contiene seis escaneos de facturas en PNG y tres PDFs escaneados solo de imágenes. Después de la sesión, una compilación y ejecución de Release independiente reprodujo cada cifra a continuación.

VerificarEsperadoLeerConfianza
sample-01.pdf3016.693016.6994.84
sample-02.pdf6710.246710.2493.19
sample-03.pdf10599.8410599.8496.17
sample-01.pdf, copia buscable3016.693016.69No impreso
Inicio rápido, seis escaneos PNGSeis filasSeis filas91.62 a 96.16
  • Cada prompt dejó una compilación de Release limpia. El Inicio rápido eligió IronOcr 2026.10.2 por su cuenta y encontró un error de compilación, que Claude Code corrigió sin ediciones manuales.
  • Un paso se ejecutó de manera diferente a lo que indica la página. Una respuesta escrita aprobó el plan del tercer prompt, en lugar de el diálogo de plan.

El registro de ejecución enumera las versiones, modelos, tiempos y máquina de prueba detrás de esta guía y las otras en el conjunto.


Solución de problemas

¿Preguntas?

Si tienes alguna pregunta, contacta a support@ironsoftware.com

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.

Leer más

¿Listo para empezar?

Descargas de NuGet 6,394,824Versión:2026.11recién lanzado