AI 코딩 비서와 IronOCR 사용하기

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

IronOCR은 600만 건 이상의 NuGet 다운로드를 기록한 .NET을 위한 상용 OCR 라이브러리입니다. 튜토리얼, 사용 방법 가이드 및 문제 해결 노트는 수년 전부터 공개되어 있어, 코딩 비서들은 대개 훈련 데이터로 그것을 본 적이 있습니다.

그 친숙함은 프로젝트가 어떤 릴리스를 고정하는지에까지는 미치지 않습니다. IronOCR의 문서를 읽는 비서는 OCR 코드를 작성하고 정확한 텍스트를 반환할 가능성이 높습니다. 첫 번째 요청 전에 문서를 공유하십시오.

이 도구는 두 가지 범주로 나뉘며, 결과를 검토하기 전에 얼마나 많은 작업을 수행하는지에 따라 다릅니다.

  • 비서는 워크플로의 한 부분 내부에서 작동합니다. GitHub Copilot의 인라인 제안과 같이 한 줄을 완성하거나, 메소드를 설명하거나, 작은 수정을 합니다.
  • 에이전트는 여러 단계의 작업을 수행하며, 파일을 편집하고, 빌드 및 테스트를 실행하고, Claude Code, ChatGPT Codex, Cursor 및 Google Antigravity와 같이 검토 결과를 커밋합니다.

설정은 둘 다 동일합니다. 패키지를 설치하고, 환경 변수에서 라이선스 키를 적용하며, IronOCR의 기계 판독 가능한 문서를 제공하고, 이미 알고 있는 페이지에 추출된 값을 확인합니다. 이는 이미지 및 스캔한 PDF에 동일하게 적용되며, 스캔을 검색 가능하게 만들기, 다중 언어 읽기, 동일한 읽기에서 바코드 추출, 또는 저품질 스캔 향상에 적용됩니다.

Claude Code AI 코딩 에이전트 로고ChatGPT Codex AI 코딩 에이전트 로고GitHub Copilot AI 코딩 보조 도구 로고Cursor AI 코드 편집기 로고Google Antigravity AI 코딩 에이전트 로고

AI 비서가 자체적으로 OCR을 처리할 수 없습니까?

문서가 없다면 비서는 훈련 중에 흡수된 OCR 코드에 의존하게 되며, 이는 종종 원시 Tesseract 래퍼나 이전 IronOCR 버전의 설정과 혼합된 것입니다.

IronOCR은 도구가 읽을 수 있도록 만들어진 문서를 게시하며, 튜토리얼, 사용 방법 가이드, 50개 이상의 문제 해결 기사가 포함되어 있습니다. 비서가 로드된 후, 문서는 IronTesseract, OcrInput, OcrResult이 어떻게 결합되는지 보여줍니다.

엔진 선택은 여전히 중요합니다. 무료 Tesseract 래퍼는 깨끗하고 똑바로 놓인 영어 페이지를 잘 처리합니다.

  • 읽을 수 있다고 해서 올바른 출력이라고 할 수는 없습니다: OCR 결과가 유창하게 읽을 수 있으면서도 589.50을 580.50으로 바꿀 수 있습니다. OcrResult은 어디를 살펴봐야 하는지를 보여주기 위해 각 단어에 대한 신뢰도 점수를 보고합니다.
  • 스캔은 준비가 필요합니다: 구부러지거나, 시끄럽거나, 저해상도의 페이지는 어떤 엔진에서도 잘 읽히지 않습니다. OcrInput은 페이지를 똑바로 세우고, 소음을 제거하고, 해상도를 올리는 필터 등을 가지고 있습니다.
  • 엔진의 수동 최적화는 비용이 많이 듭니다: 비서가 원시 Tesseract 설정을 시도할 때마다 라이브러리가 이미 수행한 작업에 토큰을 쓰게 되며, 새로운 문서 유형마다 비용이 반복됩니다.
  • 패키지는 플랫폼에 의존합니다: IronOcr은 Windows를 커버하고, IronOcr.MacOs은 Intel Mac을, IronOcr.MacOs.ARM은 Apple 실리콘을 커버합니다. 비서는 또한 그럴싸한 패키지 이름을 만들어낼 수 있으며, 공격자들은 악성 코드가 포함된 이름을 등록합니다. 이를 슬롭스쿼팅이라고 합니다. 프롬프트에 패키지 이름을 지정하십시오.
  • 라이선스는 예측 가능합니다: 클라우드 OCR 서비스는 종종 페이지당 또는 호출당 청구되며, 비서는 자체적으로 이러한 조건을 언급하지 않을 것입니다. IronOCR은 영구 상용 라이선스 하에 로컬에서 실행되며, 개발자, 위치 및 프로젝트에 따라 계층적으로 가격이 책정되며, 페이지당 계량은 없습니다.

1단계: IronOCR 설치

패키지 참조가 존재하면, 비서는 코드를 생성할 때 IronOCR의 실제 유형을 볼 수 있게 됩니다.

Install the IronOcr NuGet package into this project and confirm it restores.
Text

고급 NuGet 설치 가이드에는 다른 설치 옵션이 나와 있습니다.


2단계: 라이선스 키를 적용하세요

IronOCR는 워터마크가 있는 비라이선스 모드가 없습니다. IronTesseract을 키 없이 생성해도 성공하지만, 첫 번째 읽기 시 'Production License Required'라는 메시지와 함께 IronSoftware.Exceptions.LicensingException이 발생합니다. 존재하지만 잘못 입력된 키는 동일한 호출에서 'License Key Not Recognized'라는 메시지를 반환합니다. 아래에서 무료 체험 키를 얻을 수 있습니다.

오늘 무료 체험으로 프로젝트에서 IronOCR 사용을 시작하십시오.

첫 번째 단계:
arrow pointer

모든 IronOCR 호출 전에, 애플리케이션 시작 시 IronOcr.License.LicenseKey을 설정하고, IRONOCR_LICENSE_KEY 환경 변수에서 읽어 소스 제어에 들어가지 않도록 하십시오. 동일한 클래스에는 또한 키 문자열을 적용하지 않고 테스트하는 메서드도 있습니다.

유의 사항: IronOCR 라이선스 키는 키를 저장할 수 있는 다른 위치, Web.config 및 appsettings.json를 포함하여 다룹니다.

3단계: IronOCR의 LLM 문서에 비서를 연결하기

작업이 특정 가이드의 세부 사항에 의존할 때, 비서에게 해당 가이드의 페이지를 열도록 하십시오.

인덱스와 함께 직접적인 지침을 제공하십시오.

Before writing any IronOCR code, read https://ironsoftware.com/ocr/csharp/llms.txt
and use only APIs documented there. A read is assembled on an OcrInput, whose
Load overloads differ by source type, and run through IronTesseract.Read.
Confirm the overload you pick against
https://ironsoftware.com/ocr/csharp/object-reference/api/, and if you cannot find
it, say so instead of guessing.
Text

4단계: IronOCR 컨텍스트를 프로젝트에 추가하기

IronOCR 규칙을 팀이 이미 보관 중인 파일에 배치하십시오. Claude Code는 CLAUDE.md을 읽고, GitHub Copilot은 .github/copilot-instructions.md을 읽고, ChatGPT Codex와 Google Antigravity는 AGENTS.md을 읽습니다. Cursor는 .cursor/rules/*.mdc 또는 AGENTS.md을 읽고, 그 규칙 파일만 MDC 앞부분이 필요합니다. 다음 예제를 시작점으로 사용하십시오.

## OCR with IronOCR

This project uses IronOCR (NuGet package `IronOcr`, or `IronOcr.Linux` for Linux and Docker, namespace `IronOcr`) for all OCR work.

- Reference: https://ironsoftware.com/ocr/csharp/llms.txt
- Skill file: https://ironsoftware.com/ocr/csharp/skill.md
- Read with `IronTesseract` and an `OcrInput` inside a `using` block, and use the `OcrResult` it returns.
- Read the license key from the IRONOCR_LICENSE_KEY environment variable at startup. Never inline it.
- Every OCR change must be tested against sample pages whose text is known, reporting the values read and their confidence.
- Do not add another OCR engine or a cloud OCR service. If IronOCR cannot do something, say so.
Markdown

스킬 파일의 단일 파일 예제는 여전히 IronOcr 2026.7.2에 고정되어 있으며, NuGet에서는 현재 2026.10.2를 제공합니다. 또한 모든 Iron 패키지를 같은 버전으로 유지해야 한다고 명시하고 있습니다. 그러나 언어 팩은 IronOcr.Languages.German이 마지막으로 2020.11.2로 게시되었기 때문에 따를 수 없습니다. 원 이미지 스캔 PDF의 경우 이미지 로드, 읽기 및 SaveAsSearchablePdf 호출이 작동했을 때 하나의 줄 ConvertToSearchablePdf 레서피는 실패했습니다.


5단계: 원샷 설정 프롬프트

1단계부터 4단계까지의 모든 정보를 한 번에 메시지로 보낼 수 있습니다.

Use IronOCR for all OCR work in this project.

1. Install the IronOcr NuGet package (IronOcr.Linux when the app runs on Linux or Docker).
2. Apply the license key at application startup, before any other IronOCR call,
   reading it from the IRONOCR_LICENSE_KEY environment variable. Never write
   the key into source or into a committed file.
3. Read https://ironsoftware.com/ocr/csharp/llms.txt before writing OCR code
   and work only from APIs documented there, checking the API reference when a
   member is unfamiliar.
4. Load https://ironsoftware.com/ocr/csharp/skill.md if your tooling supports skill files.
5. Keep these instructions for future sessions in this project.
Text

6단계: 작동하는 코드를 생성하는 프롬프트 패턴

약한 결과는 대개 비서에게 추측할 여지를 남기는 프롬프트에서 발생합니다.

입력, 필드 및 언어를 지정하십시오.

모호함 IronOCR을 사용하여 송장을 읽으십시오.

더 나음 모든 스캔된 PDF를 로드하는 OcrInput과 함께 IronTesseract를 사용하여 송장 번호와 'Total Due'로 시작하는 줄을 읽고 해당 줄의 신뢰도와 함께 금액을 반환하십시오.

릴리스와 프레임워크도 명시하십시오.

더 나음 IronOcr 2026.9.4와 함께 .NET 9을 대상으로 합니다.

전체 파일을 요청하십시오.

더 나음 수정 없이 컴파일 준비된 전체 Program.cs, 지시문 및 라이선스 설정을 포함하여 반환하십시오.


7단계: 되돌아온 것을 검증하기

이 일반적인 오류를 주의하십시오.

  • 이미 텍스트가 있는 PDF에서 OCR: 실제 텍스트 레이어를 추출하는 것이 페이지에서 OCR을 실행하는 것보다 빠르고 정확합니다. 먼저 텍스트 레이어를 확인하고 스캔된 페이지에서만 OCR을 실행하십시오.
  • 모든 필터 한 번에: 깨끗한 페이지에서 하나의 수정 뒤에 또 다른 수정을 쌓으면 정확도가 떨어질 수 있으며 항상 시간이 추가됩니다. 테스트 실행의 밀집된 송장 세트에서 DeNoise은 회전된 송장 번호의 마지막 1을 4로 바꿨으며, Dilate을 추가하면 그 페이지는 수정됐지만 다른 세트는 한 줄에서 세 줄 이상이 손실되었습니다. 보이는 결함을 수정하는 필터만 적용하십시오. IronOCR의 스킬 파일은 동일한 조언을 제공하며, 이미지 품질 보정 가이드는 각 필터가 언제 적용되는지 설명합니다.

에이전트에게 자신의 작업을 검증하게 하세요

Build and run this project in Release. Confirm that every IronOCR member you used
appears in the documentation, that IronOcr.License.IsLicensed returns true, and
that every sample page reads back with the values it is known to contain.
Report the build result and a table of page, expected value, value read, confidence, and match.
Text

영어 이외의 언어를 어떻게 읽습니까?

English는 IronOcr 패키지에서 유일한 언어입니다. IronOCR의 언어 목록은 125개를 다룹니다. 비서에게 이 사실을 알려주십시오.

  • 다른 언어는 IronOcr.Languages.German처럼 해당 팩이 필요하며, 그 다음 Language = OcrLanguage.German를 사용합니다.
  • NuGet 액세스가 없으면 .ocrdata 파일과 Installation.LanguagePackDirectory를 사용하십시오.
  • 빠르고 최상의 변형인 OcrLanguage.GermanFast은 동일한 패키지로 배송됩니다.
  • 여러 언어로 된 페이지의 경우 AddSecondaryLanguage을 사용할 수 있으며, 가장 흔한 언어부터 시작합니다.
  • 금융표는 IronOcr.Languages.Financial에서 OcrLanguage.Financial을 사용합니다.
  • 다른 곳에서 훈련된 모델은 .traineddata 파일과 함께 UseCustomTesseractLanguageFile에서 로드됩니다.

누락된 팩이 처음 읽기 시 LanguagePackException을 발생시킵니다. 그 메시지에는 정확한 NuGet 패키지와 .ocrdata 대안이 명시되어 있어, 메시지가 명시한 것을 설치하도록 비서에게 지시하십시오.

IronOCR의 빠른 설정 가이드는 EnglishFast 과 바코드 읽기를 꺼놓는 것을 결합하면 17% 이득이 있음을 보고합니다. 우리의 페이지 10개에서 해당 변형은 영어의 실행 소음 내에서 머물렀으니, 정확성을 성능과 맞바꾸기 전에 여러분의 페이지에서 그 변형의 시간을 측정하십시오.

ClickOnce 퍼블리싱은 ClickOnce 참고에 설명된 것처럼 보조 언어의 .ocrdata 파일을 생략합니다. Windows에서 EnglishFast를 보조 언어로 추가하면 2025.12.3부터 2026.7.2 릴리즈의 큰 PDF에서 지연을 유발할 수 있으며, 해결 문제 항목에 기록되어 있습니다.


기본 설정에는 어떤 IronOCR 설정이 켜져 있습니까?

생성된 코드는 종종 이미 기본값으로 설정되어 있는 값을 설정하거나 기본적으로 꺼져 있는 설정을 놓칩니다. 이들은 IronOcr 2026.9.4의 초기값이며, 새 IronTesseract에서 읽은 것입니다.

환경Default교체
Language영어다른 언어들
Configuration.ReadBarCodes꺼짐바코드들
Configuration.ReadDataTables꺼짐표 구조
Configuration.RenderSearchablePdf켜짐검색 가능한 출력 건너뜀
Configuration.RenderHocr꺼짐hOCR 출력
Configuration.PageSegmentationModeAutoOsd단일 라인 또는 단일 단어 자르기
Configuration.EngineModeLstmOnly희귀
Configuration.WhiteListCharacters 및 BlackListCharacters빈좁은 문자 집합
Configuration.TesseractVariables세 가지 사전 설정 항목원시 Tesseract 변수
MultiThreaded켜짐희귀
MaxDegreeOfParallelismEnvironment.ProcessorCount메모리가 부족한 대량
OcrInput.TargetDPI0낮은 해상도 스캔

표준 읽기를 넘어, IronTesseract는 다른 입력에 맞춘 리더를 제공합니다. ReadPhoto는 문서의 사진을 처리하고, ReadScreenShot는 화면 캡처를 처리합니다. 전문 문서 튜토리얼은 여전히 그들을 위해 IronOcr.Extensions.AdvancedScan를 나열하지만, 해당 패키지는 2025년에 마지막으로 배송되었으며, 두 리더 모두 필요하지 않았습니다. 같은 튜토리얼은 또한 여권 및 차량 번호판 리더를 다룹니다.


재생산할 수 있는 결과

유의 사항: 프롬프트를 실행하려면 새로운 세션, .NET SDK, 네트워크 연결, 터미널 접근이 가능한 비서, 그리고 IronOCR 체험 또는 프로덕션 키가 필요합니다.

프롬프트

Build a .NET 9 console app that reads totals from scanned invoices. Start in an empty folder; if it already holds code or project files, stop and report. Work start to finish alone: write, build, run, and fix, making sensible assumptions where anything is unspecified. Save every deliverable under the project root, in the folders named below.

1. Install the IronOcr NuGet package pinned to version 2026.9.4.
2. Read https://ironsoftware.com/ocr/csharp/llms.txt and the pages it links to, and use only IronOCR APIs documented there for the OCR work. Any .NET imaging library may draw the test images.
3. Read the license key from the IRONOCR_LICENSE_KEY environment variable at startup and never write it into source or any output file. If IronOcr.License.IsLicensed is false, stop and report that.
4. With random seed 2026, generate testset/invoice-01.png to invoice-10.png. Each is a US Letter page of exactly 1700 x 2200 pixels, saved as PNG with 200 DPI in the file metadata, with all text in Arial inside 0.75 inch margins, headings at 14 point bold and everything else at 11 point. Each invoice has an invoice number made of INV- and six random digits, a customer name, three line items with random prices in dollars and cents, and a total equal to their sum, with no two totals alike.
5. Rotate invoice-02 and invoice-07 by 3 degrees about the page center, keeping the 1700 x 2200 canvas. Add speckle noise to invoice-04 and invoice-09: dark square specks 1 or 2 pixels wide, placed anywhere including over the text, until they have darkened 1% of the page's pixels, counting a pixel as dark below 128 of 255. Leave the other six clean. Write manifest.csv with each file, invoice number, the three prices, total, and distortion (none, rotated, or speckled).
6. Before the first OCR call, check every saved image: 1700 x 2200 pixels, 200 DPI when rounded, and, measured on each page before distortion, the smallest distance from any ink to an edge, at least 0.75 inch. On each speckled page, check that speckling raised the share of dark pixels by 0.9 to 1.1 percentage points. Also draw a capital H with the 11 point font on a 200 DPI bitmap and check that its ink is 21 to 23 pixels tall. If a check fails, fix the generator. After the first OCR call, never regenerate or change the saved image files; filters applied in memory are expected.
7. Read all 10 images in one OcrInput with one set of filters for every page. Each run of the program uses one filter set; it must not try several or choose between them, and choosing filters is your job between runs. No manifest value, file name, or expected value may steer the OCR or the parsing of its text; read the manifest only to write roundtrip.md. The reader must hold no invoice number, price, or total as a literal and must run the same code for every page. Extract each page's invoice number and total, save each page's OCR text as ocr/invoice-01.txt to invoice-10.txt, and save the result as invoices-searchable.pdf.
8. Build in Release and run.
9. Write roundtrip.md: the step 6 checks as measured numbers for every image, not pass or fail words, the filter set used, then a table of file, distortion, expected invoice number, invoice number read, expected total, total read, the Confidence (0 to 100) of the OCR line holding the total or n/a, and match, then the page count of invoices-searchable.pdf loaded back with OcrInput. A row matches only when the invoice number read is identical to the expected one and the total read equals the expected total to the cent.
10. All 10 rows must match and the PDF must have 10 pages. If not, read the saved OCR text of the failing pages, change the filter set or the reader, rebuild, and run again. If rows still fail after eight such runs, stop and report which rows failed, the filter sets tried, and why.
11. Finish with a short report: build result, match count, filters used, font sizes used, and assumptions made.
Text

산출

Speckled test invoice that IronOCR read correctly in the acceptance test run

이것은 실행에서 나온 두 개의 점이 많은 페이지 중 하나인 invoice-09로, 인쇄된 영역으로 자른 것입니다. 간단한 읽기에서는 10개의 송장을 맞췄고 두 개의 점이 많은 페이지는 놓쳤으며, 이 페이지의 송장 번호는 ANV-938066으로 반환되었고 Deskew만으로도 더 나아지지 않았습니다. DeNoise가 추가되면 IronOCR은 INV-939066과 1731.53을 반환했으며, 총합 라인에서 41.45의 신뢰도를 보였고, 이는 실행에서 가장 낮았습니다. 다른 점이 많은 총합 라인은 63.86에서 읽혔으며 깨끗한 페이지는 약 95였습니다. Claude Code는 초안에서 두 필터를 선택하고 프로그램의 다섯 번 실행 동안 유지했습니다.

  • 독립적인 검사는 모든 요구 사항을 다시 측정했으며, 모든 10개의 송장이 일치했습니다.
  • GPT-6 Luna를 사용한 ChatGPT Codex도 동일한 프롬프트에서 10개 중 10개를 맞췄습니다.
  • roundtrip.md은 편집되지 않은 상태로 게시되며, invoice.png는 축소된 크기로 제공됩니다.

통과 조건

  • 해당 코드는 귀하로부터 어떤 수정도 필요하지 않았습니다.
  • 이미지를 열면 가장자리에서 잘려진 부분 없이 작은 문자가 표시되며, 문자와 여백에도 점이 있습니다.
  • roundtrip.md의 각 송장 번호와 총합도 해당 페이지의 저장된 OCR 텍스트에 나타납니다.
유의 사항: IronOCR 변경 로그는 각 릴리즈에서 변경된 내용을 나열합니다.

실행 기록

  • 해당 기기는 Core i9-14900KF와 64GB 메모리를 탑재한 Windows 11 x64에서 실행됩니다.
  • 모든 프로젝트는 .NET 9을 타겟으로 설정합니다.
  • 이 가이드, Copilot 및 Cursor는 IronOcr 2026.9.4를 실행했으며, Claude Code, Codex 및 Antigravity는 2026.10.2를 실행했습니다. Copilot은 IronOcr.Linux 2026.9.4를 추가했고, Codex, Cursor 및 Antigravity는 IronOcr.Languages.German 2020.11.2를 추가했습니다.
  • 마지막 테스트는 2026년 10월 8일, Cursor 실행과 함께 이루어졌습니다. 다른 모든 실행은 10월 6일에 진행되었습니다.
가이드보조 및 버전모델기간 (분)
이 가이드Claude Code 2.1.277, 권한 프롬프트 끄기Claude Opus 520.8
Claude CodeClaude Code 2.1.277Claude Sonnet 59.4
ChatGPT CodexCodex CLI 0.160.0GPT-6 Luna27.7
GitHub CopilotVS Code 1.140에서의 Copilot 에이전트 모드GPT-6 Luna, 자동 경로에 의해 라우팅됨22.0
CursorCursor 3.23.23 데스크탑 앱Grok 4.783.5
Google AntigravityAntigravity CLI 1.3.0Gemini 3.8 Flash (높음)32.7

에이전트별 가이드

한 도구에 맞는 단계는 해당 가이드를 열어보십시오.


문제 해결


질문?

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

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

더 읽기

시작할 준비 되셨나요?

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