IronOCR와 Claude Code 사용법

Curtis Chau
Curtis Chau
업데이트됨: 2026년 10월 9일

AI 에이전트를 사용해 스캔된 청구서에서 총계를 추출하는 것은 간단해 보이지만, 비뚤어진 스캔이나 얼룩진 스캔이 7을 1로 바꾸고 이에 대한 인지를 아무도 하지 않으면, 채무 부서에서 문제가 발생할 수 있습니다. Claude Code, Anthropic의 코딩 에이전트는 터미널, VS Code, JetBrains, 데스크탑 앱, 그리고 브라우저에서 실행됩니다. Claude Code는 코드를 읽고 파일을 편집하며 명령을 실행합니다. 이는 페이지에서 읽은 값이 일치하지 않을 때마다 코드를 변경해야 하는 OCR 작업에 적합합니다.

IronOCR는 조정된 Tesseract 엔진을 로컬에서 실행하므로 OCR 처리 중 어떠한 데이터도 외부 서비스로 전송되지 않습니다. Claude Code는 읽은 내용을 모델에 전송하며, 코드가 출력하는 텍스트 또한 포함됩니다. 따라서 실제 공급자 청구서가 아닌 샘플 페이지를 대상으로 개발하십시오. Claude Code는 읽기 도구를 작성하고, 알려진 값이 있는 페이지를 생성하며, 작업 완료를 보고하기 전에 모든 결과를 비교할 수 있습니다.

모델은 스타일에 따라 다릅니다. 같은 프롬프트를 받아도 두 모델은 다른 클래스 이름과 구조를 선택할 수 있으며, 사용자가 지정한 것만 일치할 수 있습니다. 프롬프트 섹션에 나와 있는 것처럼 중요한 세부 사항을 명시하고 나머지는 모델이 결정하도록 하십시오.

빠른 시작
NuGetNuGet으로 설치

PM > Install-Package IronOcr

위 명령을 NuGet 패키지 관리자 콘솔에 입력하거나 NuGet 패키지 관리자에서 패키지를 검색하여 IronOCR를 설치하십시오.

.NET 프로젝트에서 Claude Code를 시작하고 /model sonnet와 함께 Sonnet으로 전환한 후 이 프롬프트를 전송하십시오.

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

프롬프트가 세부 사항을 열어두면 Claude Code가 그 세부 사항을 결정합니다. 이는 목표 프레임워크를 유지하고 자체 이름을 선택합니다. 빠른 테스트에는 충분합니다. 프로덕션 코드에는 프롬프트에 IronOCR 버전을 명시하여 코드가 알려진 API를 대상으로 하도록 하십시오.



.NET OCR 프로젝트에서 Claude Code는 무엇을 합니까?

OCR 프로젝트에서 Claude Code는 청구서 읽기를 작성하고 각 페이지를 읽습니다. 총계가 틀리거나 페이지에서 텍스트가 없을 때는 읽기를 조정하고 다시 시도합니다. 문서를 설명하고 결과를 검토합니다.

  • 스캔 정리는 기본 내장: IronOCR의 입력 객체는 이미 교정 필터를 제공하므로 에이전트는 자체 이미지 처리를 작성하기보다는 이를 적용합니다.
  • 유지 관리 후 엔진이 조정 작업을 줄입니다: 수작업으로 구성된 Tesseract 설정은 신뢰하기 전에 테스트가 필요합니다. AI 코딩 보조 가이드에는 기기에서 실행할 수 있는 테스트가 포함되어 있습니다.
  • 각 플랫폼에는 고유의 패키지가 있습니다: 인텔 맥은 IronOcr.MacOs을 사용하고, 애플 실리콘 맥은 IronOcr.MacOs.ARM을 사용합니다. 패키지를 추측하는 에이전트는 공격자가 모델이 발명하는 이름으로 게재한 유사물을 설치할 수 있습니다. 이러한 공격은 슬로프스쿼팅으로 알려져 있습니다.

Claude Code를 어떻게 설정하나요?

Anthropic의 quickstart로 Claude Code를 설치하고 로그인하세요. 시작하고 응답할 때 환경이 준비됩니다.

Claude Code가 작업할 수 있는 프로젝트를 어떻게 설정하나요?

에이전트를 시작하기 전에 콘솔 프로젝트를 만드십시오. Claude Code는 각 세션 열기 시 CLAUDE.md을 읽으며, 한 프롬프트가 파일을 생성합니다.

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

첫 번째 읽기 전에 라이선스를 해결하십시오. 유효한 키가 없으면 IronOCR의 Read 메서드는 워터마크를 추가하거나 출력을 저하시키지 않습니다. LicensingException을 던집니다. 해당 타입은 공개되지 않았으므로 코드가 이름으로 예외를 잡는 대신 시작 시 License.IsLicensed을 확인하십시오. IronOCR 라이선스 키 페이지에서는 키 얻기와 저장을 다룹니다.

IronOCR 코드가 컴파일되도록 프롬프트를 작성하는 방법은?

터미널에서 Shift+Tab을 눌러 계획 모드가 켜질 때까지 기다린 다음 이 프롬프트를 전송하십시오.

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

이 프롬프트가 작동하는 두 가지 세부 사항이 있습니다.

  1. 지정된 파일: 코드는 원하는 위치에 정확히 도착합니다.
  2. 확신: 낮은 신뢰도로 읽은 올바른 값은 다음 스캔이 잘못 읽힐 수 있음을 경고하며, 표는 이를 시각화합니다.

결과 코드가 짧습니다. 엔진을 생성하고 using 선언 내부에 PDF를 로드하며 Read을 호출하고 결과의 줄을 검색하여 총계를 찾아 SaveAsSearchablePdf와 함께 검색 가능한 사본을 작성합니다. 스캔된 PDF 입력 가이드와 검색 가능한 PDF 가이드가 두 단계 모두를 다룹니다.

한 가지 지름길을 주의하십시오. IronOCR의 스킬 파일은 한 줄 변환을 위한 IronTesseract.ConvertToSearchablePdf을 제공하며, 두 번의 테스트에서 Claude Code는 먼저 이를 선택했습니다. 이미지만 있는 스캔에서는 IronOCR 2026.9.4와 2026.10.2 모두에서 "PDF 문서가 이미지를 포함하지 않음"을 던집니다. Claude Code는 오류를 읽고 위 접근법으로 전환하여 성공했습니다.

어떤 IronOCR 설정이 CLAUDE.md에 포함되야 합니까?

세 가지 IronOCR 결정을 해결하십시오.

  • 언어: IronOcr.Languages.German는 2020.11.2에서 멈추며 엔진은 매월 출시됩니다. IronOCR의 여러 언어 가이드는 추가 언어가 속도와 성능에 영향을 줄 수 있음을 경고합니다.
  • 필터: 우리의 탐색에서는 아래 규칙에 나열된 두 필터를 $9,924.31 총계 주위의 작은 크롭에 읽기할 때 단 하나의 점으로 줄였습니다.
  • 읽기 방법: 사진 방법은 우리 탐색에서 기본 IronOCR 2026.9.4 패키지로 실행되었으며, 설치 없이 실행되었지만, 사진 읽기 가이드는 여전히 IronOcr.Extensions.AdvancedScan을 요구 사항으로 나열합니다.
## 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가 MCP를 통해 IronOCR와 연결할 수 있습니까?

Claude Code는 한 명령으로 MCP 서버를 추가할 수 있으며, MCP 참조에서 이를 설명하지만, IronOCR는 필요하지 않습니다. 문서 색인과 프로젝트의 규칙 파일에 연결된 스킬 파일은 호스트나 재시작 필요 없이 에이전트에게 현재 API, 레시피 및 수정을 제공합니다.

생성된 OCR 코드를 신뢰하기 전에 확인해야 할 사항은 무엇입니까?

각 변경 후에 다음 세 가지 확인을 순서대로 완료하십시오.

  • 빌드 통과 여부: 발명된 멤버는 dotnet build을 실패할 수 있으므로 먼저 실행하십시오.
  • 기본값이 작업에 적합한지: 코드가 의존하는 설정을 확인하십시오. Configuration.ReadBarCodes는 기본적으로 꺼져 있습니다.
  • 실패가 처리되었는지: 실패 경로를 이름으로 요청하십시오. 디버깅 가이드는 로깅과 IronOCR가 발생시키는 예외를 다룹니다.

어떤 OCR 작업이 에이전트에 적합합니까?

작업적합왜
검색 가능한 PDF강한텍스트 레이어 확인 가능
여러 업로드 경로 전반의 하나의 리더강한패턴이 반복됨
실제 스캔에 대한 조정혼합스캔의 결함을 인지할 수 없음
라이선스 및 Linux 배포약함키와 서버에 따라 달라짐

혼합 및 약한 행의 경우, 에이전트에게 실제 샘플 스캔 또는 배포 세부 정보를 제공하고 결과를 더 면밀히 검토하십시오.

실제 실행에서 프롬프트가 무엇을 생성했습니까?

이 가이드의 세 가지 프롬프트는 새 .NET 9 콘솔 앱을 대상으로 하여 여섯 개의 PNG 청구서 스캔과 세 개의 이미지 전용 스캔된 PDF로 실행되었습니다. 세션 후, 독립적인 Release build 및 실행이 아래의 모든 수치를 재현했습니다.

확인예상되는 결과읽기확신
sample-01.pdf3016.693016.6994.84
sample-02.pdf6710.246710.2493.19
sample-03.pdf10599.8410599.8496.17
sample-01.pdf, 검색 가능한 사본3016.693016.69출력되지 않음
Quickstart, 여섯 개의 PNG 스캔여섯 행여섯 행91.62 ~ 96.16
  • 각 프롬프트는 깨끗한 Release 빌드를 남겼습니다. Quickstart는 자동으로 IronOcr 2026.10.2을 선택하고 컴파일 오류 하나를 잡았으며, Claude Code가 수작업 없이 이를 수정했습니다.
  • 한 단계가 페이지와 다르게 실행되었습니다. 타자로 작성된 응답이 계획 대화 상자 대신 세 번째 프롬프트의 계획을 승인했습니다.

실행 기록은 이 가이드와 셋의 다른 가이드를 뒷받침하는 버전, 모델, 타이밍 및 테스트 머신을 나열합니다.


문제 해결

질문?

질문이 있으시면 support@ironsoftware.com으로 문의하세요.

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

더 읽기

시작할 준비 되셨나요?

NuGet 다운로드 수 6,394,824버전:2026.11방금 출시