IronOCRをClaude Codeで使用する方法

Curtis Chau
Curtis Chau
更新日: 2026年10月9日

AIエージェントを使ってスキャンした請求書から合計を抽出するのは一見簡単ですが、斜めや斑点のあるスキャンが7を1に変えてしまい、経理が気づく前に誰も気づかないことがあります。 AnthropicのコーディングエージェントであるClaude Codeは、ターミナル、VS Code、JetBrains、デスクトップアプリ、ブラウザで実行されます。 コードを読み、ファイルを編集し、コマンドを実行します。これは、ページから読み取った値が一致しないときにコードを変更する必要があるOCR作業に適しています。

IronOCRは調整されたTesseractエンジンをローカルで実行し、OCR処理によってデータが外部サービスに送信されることはありません。 Claude Codeは読み取ったものすべてをモデルに送信します。コードが出力するテキストも含めて。そのため、実際の供給者の請求書ではなくサンプルページに対して開発を行ってください。 Claude Codeはリーダーを書き、既知の値を持つページを生成し、それらと全ての結果を比較してタスクの完了を報告します。

モデルはスタイルが異なります。 同じプロンプトに対して、2つのモデルは異なるクラス名と構造を選択し、指定したことのみに同意することがあります。 以下のプロンプトセクションが示すように、重要な詳細を明記し、残りはモデルに任せます。

クイックスタート
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コーディングアシスタントガイドには、マシンで実行できるテストが含まれています。
  • 各プラットフォームには独自のパッケージがあります: Intel MacはIronOcr.MacOsを使用し、Apple silicon MacはIronOcr.MacOs.ARMを使用します。 パッケージを推測するエージェントは、攻撃者がモデルが考案する傾向のある名前で公開した類似パッケージをインストールできる、この攻撃はslopsquattingとして知られています。

Claude Codeをどのように設定しますか?

AnthropicのクイックスタートでClaude Codeをインストールしてサインインします。 起動して返信が来ると、環境が整っています。

プロジェクトClaude Codeが作業できるようにするにはどうすればよいですか?

エージェントを開始する前にコンソールプロジェクトを作成してください。 Claude Codeは各セッションの開始時にCLAUDE.mdを読み取り、1つのプロンプトでファイルを作成します。

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

このプロンプトを機能させる2つの詳細事項があります。

  1. 名前付きファイル: コードはまさに望む場所に配置されます。
  2. 信頼性: 低信頼性で読み取られた正しい値は、次のスキャンが誤認される可能性があると警告し、表でそれを可視化します。

生成されたコードは短いです。 エンジンを作成し、使用宣言内でPDFをロードし、Readを呼び出し、結果の行を合計に対して検索し、SaveAsSearchablePdfで検索可能なコピーを書き込みます。 スキャンされたPDF入力ガイドと検索可能なPDFガイドでこれらのステップがカバーされています。

1つのショートカットを見逃さないようにしてください。 IronOCRのスキルファイルは1行の変換用にIronTesseract.ConvertToSearchablePdfを提供しており、Claude Codeは2回のテストで最初にそれを使用しました。 画像のみのスキャンでは、IronOCR 2026.9.4および2026.10.2で「PDFドキュメントには画像が含まれていません」というエラーがスローされます。Claude Codeはエラーを読み、上記のアプローチに切り替えて成功しました。

CLAUDE.mdに含めるべきIronOCRの設定は?

そこに3つのIronOCRの決定を記載してください。

  • 言語: IronOcr.Languages.Germanは2020.11.2で停止しますが、エンジンのリリースは毎月です。 IronOCRの複数言語ガイドでは、追加言語が速度とパフォーマンスに影響を与える可能性があると警告しています。
  • フィルター: 調査では、以下のルールに記載された2つのフィルターを$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リファレンスで説明されているように1つのコマンドでMCPサーバーを追加できますが、IronOCRは必要ありません。 ドキュメンテーションインデックスとプロジェクトのルールファイルからリンクされたスキルファイルで、エージェントは、ホストや再起動なしで現在のAPI、レシピ、および修正を得ます。

生成されたOCRコードを信用する前に何を検証すべきか?

各変更後、順番にこれらの3つのチェックを完了してください。

  • ビルドが通る: 作成されたメンバーがdotnet buildに失敗した場合、最初にそれを実行してください。
  • デフォルトが仕事に適している: コードが頼っている設定を確認してください。 デフォルトではConfiguration.ReadBarCodesはオフです。
  • 失敗時はハンドルされる: 名前で失敗の経路を尋ねてください。 デバッグガイドは、IronOCRが発生する記録および例外をカバーしています。

どのOCRタスクにエージェントが適しているか?

タスク適合なぜ
検索可能なPDF強いテキスト層を確認できます
複数のアップロードパスにわたる1つのリーダー強いパターンが繰り返されます
実際のスキャンで調整混合スキャンの欠陥を見ることができません
ライセンスおよびLinux展開弱いキーとサーバーに依存します

混在した弱い行の場合、エージェントに実際のサンプルスキャンまたは展開の詳細を与えて、結果をより詳しく確認してください。

プロンプトが実運用で生成したものは何ですか?

このガイドの3つのプロンプトが、新しい.NET 9コンソールアプリで6つのPNG請求書スキャンと3つの画像のみのスキャンPDFを保持している状態で順番にClaude Codeに送信されました。 セッション後、独立したリリースビルドと実行によって、以下のすべての数値が再現されました。

チェック期待されるもの読み取り信頼度
sample-01.pdf3016.693016.6994.84
sample-02.pdf6710.246710.2493.19
sample-03.pdf10599.8410599.8496.17
sample-01.pdf、検索可能なコピー3016.693016.69印刷されていません
クイックスタート、6つのPNGスキャン6行6行91.62から96.16
  • 各プロンプトはクリーンなリリースビルドを残しました。 クイックスタートはIronOcr 2026.10.2を自動的に選び出し、1つのコンパイルエラーが発生し、Claude Codeは手作業の編集なしで修正しました。
  • 1つのステップがページと異なって実行されました。 打鍵返信で3番目のプロンプトの計画が承認され、ダイアログの代わりを果たしました。

実行記録には、このガイドおよびセット内の他のガイドのバージョン、モデル、タイミング、テスト機のリストがあります。


トラブルシューティング

質問ありますか?

質問がある場合は、support@ironsoftware.com にお問い合わせください。

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

もっと読む

準備はできましたか?

NuGetダウンロード数 6,394,824バージョン:2026.11ちょうどリリースされました