Como usar IronOCR com o Claude Code

Curtis Chau
Curtis Chau
Atualizado: 9 de outubro de 2026

Usar um agente de IA para extrair totais de faturas digitalizadas parece simples até que uma digitalização desalinhada ou salpicada transforme um 7 em um 1 e ninguém perceba antes que a contabilidade pagável o faça. Claude Code, o agente de codificação da Anthropic, roda no terminal, no VS Code e JetBrains, como um aplicativo de desktop e no navegador. Ele lê código, edita arquivos e executa comandos, o que se adapta ao trabalho de OCR onde o código deve mudar sempre que um valor lido de uma página não coincidir.

IronOCR executa um motor Tesseract ajustado localmente, então o processamento de OCR não envia dados para serviços externos. Claude Code envia o que ele lê para o modelo, incluindo o texto que seu código imprime, então desenvolva contra páginas de amostra em vez de faturas reais de fornecedores. Claude Code pode escrever o leitor, gerar essas páginas com valores conhecidos e comparar cada resultado com elas antes de relatar uma tarefa concluída.

Os modelos variam em estilo. Dado o mesmo prompt, dois modelos podem escolher nomes de classes e estruturas diferentes e concordar apenas no que você especificou. Indique os detalhes que importam, como a seção de prompt abaixo mostra, e deixe o modelo decidir o resto.

Início Rápido
NuGetInstalar com NuGet

PM > Install-Package IronOcr

Instale o IronOCR executando o comando acima no Console do Gerenciador de Pacotes NuGet, ou procure pelo pacote no Gerenciador de Pacotes NuGet.

Inicie o Claude Code em um projeto .NET, mude para Sonnet com /model sonnet e envie 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

Se um prompt deixar detalhes em aberto, Claude Code os decide. Ele mantém seu framework alvo e escolhe seus próprios nomes. Isso é bom para um teste rápido. Para código de produção, indique a versão do IronOCR no prompt para que o código vise uma API conhecida.



O que o Claude Code faz em um projeto de OCR .NET?

Em um projeto de OCR, o Claude Code escreve o leitor de faturas e lê cada página. Quando um total está errado ou uma página não retorna texto, ele ajusta a leitura e tenta novamente. Você descreve os documentos e revisa os resultados.

  • A limpeza de digitalização está integrada: o objeto de entrada do IronOCR já fornece filtros de correção, então o agente aplica um em vez de escrever seu próprio processamento de imagens.
  • Um motor mantido salva trabalho de ajuste: uma configuração manual do Tesseract precisa de testes antes que você possa confiar nela. O guia de assistentes de codificação de IA inclui um teste que você pode executar na sua máquina.
  • Cada plataforma tem seu próprio pacote: Macs Intel usam IronOcr.MacOs e Macs com chips da Apple usam IronOcr.MacOs.ARM. Um agente que adivinhar o pacote pode instalar um sósia que um atacante publicou sob um nome que os modelos tendem a inventar, um ataque conhecido como slopsquatting.

Como você configura o Claude Code?

Instale o Claude Code com o quickstart da Anthropic e faça login. Quando começa e responde, o ambiente está pronto.

Como você configura um projeto no qual o Claude Code possa trabalhar?

Crie um projeto de console antes de iniciar o agente. Claude Code lê CLAUDE.md quando cada sessão é aberta, e um prompt cria o arquivo.

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

Resolva o licenciamento antes da primeira leitura. Sem uma chave válida, o método Read do IronOCR não marca d'água nem degrada a saída. Ele lança uma LicensingException. Esse tipo não é público, então faça o código verificar License.IsLicensed na inicialização em vez de capturar a exceção pelo nome. A página Chaves de Licença do IronOCR abrange como obter e armazenar uma chave.

Como você solicita código IronOCR que compila?

No terminal, pressione Shift+Tab até que o modo de plano esteja ativado, depois envie 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

Dois detalhes fazem este prompt funcionar.

  1. Arquivos nomeados: o código aterrissa exatamente onde você deseja.
  2. Confiança: um valor correto lido com baixa confiança avisa que a próxima digitalização pode ser lida erroneamente, e a tabela torna isso visível.

O código resultante é curto. Ele cria o motor, carrega o PDF dentro de uma declaração using, chama Read, procura pelas linhas do resultado pelo total e escreve a cópia pesquisável com SaveAsSearchablePdf. O guia de entrada de PDF digitalizado e o guia de PDF pesquisável abrangem ambas as etapas.

Fique atento para um atalho. O arquivo de habilidades do IronOCR oferece IronTesseract.ConvertToSearchablePdf para uma conversão de uma linha, e Claude Code alcançou-o primeiro em ambos os nossos testes. Em digitalizações só de imagem, ele lança "PDF document does not contain any images" no IronOCR 2026.9.4 e 2026.10.2. Claude Code leu o erro, mudou para a abordagem acima e teve sucesso.

Quais configurações do IronOCR pertencem ao CLAUDE.md?

Decida três decisões do IronOCR lá.

  • Idiomas: IronOcr.Languages.German para em 2020.11.2 enquanto o motor é lançado mensalmente. O guia de múltiplos idiomas do IronOCR alerta que idiomas adicionais podem afetar a velocidade e o desempenho.
  • Filtros: em nossa sonda, adicionar os dois filtros nomeados na regra abaixo a uma leitura de uma linha única de uma pequena área ao redor do total de $9,924.31 reduziu-a para um único ponto.
  • O método de leitura: o método photo foi executado no pacote básico do IronOCR 2026.9.4 durante nossa sonda, sem instalação extra, embora o guia de leitura de fotos ainda liste 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

O Claude Code pode se conectar ao IronOCR por meio do MCP?

Claude Code pode adicionar um servidor MCP com um comando, como explica a referência MCP, mas o IronOCR não precisa de um. O índice de documentação e o arquivo de habilidades ligados ao arquivo de regras do projeto fornecem ao agente a API atual, receitas e correções sem precisar hospedar ou reiniciar nada.

O que você deve verificar antes de confiar no código OCR gerado?

Complete esses três testes em ordem após cada mudança.

  • A compilação passa: um membro inventado falha em dotnet build, então execute-o primeiro.
  • Os padrões se adequam ao trabalho: verifique as configurações das quais o código depende. Configuration.ReadBarCodes está desativado por padrão.
  • Falhas são tratadas: peça os caminhos de falha pelo nome. O guia de depuração cobre log e as exceções que o IronOCR levanta.

Quais tarefas de OCR são adequadas para um agente?

TarefaAjustePor quê
PDFs pesquisáveisForteA camada de texto pode ser verificada
Um leitor em vários caminhos de uploadForteO padrão se repete
Ajuste em digitalizações reaisMistoEle não pode ver os defeitos de suas digitalizações
Licenciamento e implantação LinuxFracoDepende de sua chave e servidores

Para as linhas mistas e fracas, dê ao agente amostras reais de digitalizações ou detalhes de sua implantação e revise o resultado mais de perto.

O que os prompts produziram em uma execução real?

Os três prompts neste guia foram para o Claude Code em ordem, contra um novo aplicativo de console .NET 9 contendo seis digitalizações de faturas em PNG e três PDFs digitalizados apenas de imagem. Após a sessão, uma compilação e execução independente em Release reproduziu todas as figuras abaixo.

VerificarEsperadoLerConfiança
sample-01.pdf3016.693016.6994.84
sample-02.pdf6710.246710.2493.19
sample-03.pdf10599.8410599.8496.17
sample-01.pdf, cópia pesquisável3016.693016.69Não impresso
Início rápido, seis digitalizações PNGSeis linhasSeis linhas91.62 a 96.16
  • Cada prompt deixou uma compilação limpa em Release. O Quickstart escolheu IronOcr 2026.10.2 por conta própria e encontrou um erro de compilação, que Claude Code corrigiu sem edições manuais.
  • Um passo rodou de forma diferente do que estava na página. Uma resposta digitada aprovou o plano do terceiro prompt, no lugar do diálogo de plano.

O registro de execução lista as versões, modelos, tempos e máquina de teste por trás deste guia e dos outros no conjunto.


Solução de problemas

Questões?

Se você tiver dúvidas, entre em contato com support@ironsoftware.com

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.

Leia Mais

Pronto para começar?

Downloads no NuGet 6,394,824Versão:2026.11recém-lançado