IronPrintを使用してClaude Codeで印刷する方法

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

病院の研究所では、1つのサービスから3種類の文書を印刷します。検体ラベルは採集デスクのラベルプリンターへ、結果報告書は事務所のプリンターへ、そして宅配便の伝票は発送室へ送られます。 ルーティングファイルは各文書タイプに対するプリンター名を定義し、そのファイルに1文字でも間違いがあれば、患者の結果が誤った部屋へ送られてしまう可能性があります。 Claude Codeは、Anthropicのエージェントコーディングツールで、リポジトリ内のファイルを編集し、コマンドを実行します。 これはコマンドラインツール、VS CodeとJetBrainsエディター拡張機能、Claudeデスクトップアプリ、およびclaude.ai/codeで利用できます。

IronPrintは.NETからPDFや画像を印刷します。静かに行うか、オペレーティングシステムのダイアログを通じて行うことができます。 PrintSettings.PrinterNameプロパティはジョブのプリンターを選択し、Printer.GetPrinterNamesはマシンにインストールされているプリンターを一覧表示します。以下の4つのテスト済みプロンプトは、その研究所のためにClaude Codeがプリンタールーターを構築し、それらの間のセクションでは各プロンプトが依存するIronPrintの動作を記録しています。

クイックスタート
NuGetNuGet でインストール

PM > Install-Package IronPrint

NuGetパッケージマネージャーコンソールで上記のコマンドを実行するか、NuGetパッケージマネージャーでパッケージを検索して、IronPrintをインストールします。

プロジェクトフォルダーで開いたターミナルでclaudeを開始し、最初のプロンプトを送信する前に/model opusplanを使用してモデルを切り替えます。 パスの前に@を入力すると、そのファイルの内容を要求に含めることができます。

Add the IronPrint NuGet package, version 2026.10.1, to LabPrintRouter.csproj.
Then have Program.cs check the printer names in @config/printer-routes.json.

The program does this, in order:

1. Applies the license key and prints License.IsLicensed.
2. Prints each name from Printer.GetPrinterNames on its own line, in quotes.
3. Prints each route's document type, its printer name in quotes, and installed or missing.

A route's printer counts as installed only on an exact match, case and spaces included.
Don't send any print job. Every printer on this machine opens a Save dialog.

My key is in the IRONPRINT_LICENSE_KEY environment variable.
Program.cs reads it at startup and assigns it to License.LicenseKey.
Don't print its value, and don't dump the environment to find it.
If you check the variable, a yes or no on whether it's set is enough.
Text

出力内の引用符はトレーリングスペースを可視化します。



.NET印刷プロジェクトでClaude Codeは何をしますか?

エージェントはルーティングファイルを読み込み、各設定されたプリンター名をインストールされたプリンターと比較し、すべての文書のための決定を記録するルーティングサービスを作成します。 Claude Codeはプログラムとテストを実行し、それらが報告するときの失敗を修正することもできます。 開発者は各文書タイプにどのプリンターを使用するかを決定します。

最初のプロンプトにパッケージ名とバージョンを記載します。 slopsquattingと呼ばれる攻撃では、攻撃者が言語モデルが誤認する名前で有害なパッケージを登録します。 エージェントが自分でパッケージ名を選択すると、それらのパッケージの1つをインストールする可能性があります。

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

インストールと最初のサインインは、Anthropicのクイックスタートに従って行われます。 claudeがターミナルでセッションを開き、プロンプトに応答するとセットアップは完了です。

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

最初のプロンプトの前に入力をリポジトリに置いておきます。 このガイドのサンプルプロジェクトは、net9.0-windows用の.NET 9コンソールアプリ、4つの文書タイプ用のルーティングファイル、および文書タイプで始まる7つのPDFの受信トレイを持っています。 1つのルートはインストールされたプリンターの正確な名前を使用します。 他の3つはインストールされていないプリンター、異なるケースのインストールされた名前、そしてトレーリングスペースのあるインストールされた名前を使用します。

セッション開始時にClaude CodeがCLAUDE.mdを読み込むため、そのルールは後のすべてのセッションで適用されます。 クイックスタートがパッケージを追加した後、2番目のプロンプトはそのファイルを書き込み、印刷コードのレビューを行う読み取り専用サブエージェントを定義します。

Add a Printing section to a new CLAUDE.md at the repository root.
Later sessions should follow these rules from it:

- All printing goes through IronPrint. Add no other printing library.
- The package is IronPrint, at the version LabPrintRouter.csproj references now.
- Look up IronPrint member names in docs/IronPrint.xml.
- config/ and inbox/ are inputs. Leave them unchanged.
- The program sends no print job unless it runs with --send.
- Never run it with --send on this machine.
- Read the key from IRONPRINT_LICENSE_KEY. Never print it, save it, or dump the environment.

Copy IronPrint.xml to docs/ now, from the ironprint 2026.10.1 folder of the local NuGet cache.
Use the one under lib/net7.0-windows7.0.
If it isn't there, tell me, and still add the subagent below.

Then create a subagent at .claude/agents/printer-name-auditor.md.
Limit its tools to Read, Grep and Glob.
It reviews Services/ and returns three lists:

- IronPrint types and members in use, flagging any that docs/IronPrint.xml lacks.
- Types under IronSoftware.*, listed apart, since they ship in other assemblies.
- Every place a PrinterName gets set, and whether that name passed an exact installed check first.
Text

Claude Codeは.claude/agentsを監視し、セッション開始時にフォルダが存在していた場合のみ、再起動なしで新たに追加されたサブエージェント定義をロードします。 したがって、サンプルリポジトリには、.gitkeepファイルが空の状態でフォルダがセッションを開く前に存在します。 IronPrintのllms.txtは、その使い方ガイド、エージェントスキル、およびその他の文書を索引化しています。

最初の印刷呼び出しの前にライセンスキーを適用します。 キーがないと、Printer.PrintとPrinter.PrintAsyncがスローされ、ジョブはキューに入られません。 IronPrintライセンスキーページでは、トライアルキーを提供するとともに、コードの割り当てと構成ファイル設定の両方を表示します。

どのIronPrintプリンタールールがCLAUDE.mdに属しますか?

ライセンスされた場合とされていない場合で、IronPrint 2026.10.1の各行の背後の動作を調査しました。 印刷セクションの下にブロックを貼り付けます。

These printer rules come from probes on IronPrint 2026.10.1:

- PrintSettings.PrinterName must equal a Printer.GetPrinterNames() entry, character for character.
- Any other name sends the job to the Windows default printer, and nothing throws.
- That covers a missing printer, a different case, a trailing space and an empty string.
- Decide whether to print with StringComparison.Ordinal.
- A trimmed or case-blind match may label a near miss, but it never sends a job.
- Printer.GetPrinterTrays() returns an empty list for a name that isn't installed.
- An empty tray list is also normal for some real printers, so it can't test a name.
- Printer.GetPrinterNames() works without a key, so a printer list proves nothing about licensing.
- IronPrint doesn't read IRONPRINT_LICENSE_KEY by itself. Assign License.LicenseKey at startup.
- Assigning a null key doesn't throw. License.IsLicensed just stays false.
- Without a key, Printer.Print throws AggregateException with a LicensingException inside.
- Without a key, Printer.PrintAsync throws LicensingException directly.
- LicensingException is IronSoftware.Exceptions.LicensingException, internal to IronPrint.dll.
- Print and PrintAsync both wait on the driver, and a Save dialog keeps them waiting.
Markdown

2つの例外形状がエラー処理に影響を与えます。 ハンドラーはPrintAsyncからの例外をチェックしますが、Printからの内部例外をチェックします。 どちらもcatch (LicensingException)を使用することはできません。そのタイプは公開されていないため、その条項にCS0122が失敗しました。

一致しないプリンター名はIronPrintで拒否されますか?

プリンター名を指定するガイドによれば、名前の比較は大文字小文字を区別し、間違った名前は静かに失敗するかエラーを引き起こします。 私たちの調査では、インストールされていない4つの名前の下で2ページの報告書を送りました。 名前は、インストールされていないプリンター名、インストールされた'Adobe PDF'に対して'Adobe PDF'、スペースが付いたインストールされた名前、そして空の文字列でした。 4つの呼び出しのいずれもスローされず、すべてのジョブがテストマシンでデフォルトのキューであるMicrosoft Print to PDFに送られました。

したがって、ルーターは印刷メソッドを呼び出す前に、各設定された名前をインストールされた名前と自分で比較する必要があります。

IronPrintはどのようにして印刷ジョブを構築しますか?

IronPrintはPrintSettings.Dpiでの解像度で、各PDFのページをドライバーに画像として送信します。 Microsoft Print to PDFへの調査ジョブは、150 DPIでレンダリングされた、テキストレイヤーなしの1239 x 1754ピクセルの単一画像を持つ2ページのA4 PDFを生成しました。 ガイドのサンプル出力は、デフォルトの300 DPIで同じパターンをたどり、A4ページごとに2479 x 3508ピクセルです。 PDFプリンターの出力を確認するには、したがって、ページ数または画像を比較する必要があります。印刷されたテキストは検索できません。

印刷することなくジョブを検査するために、テストセットアップでは、IronPrintがWindowsで使用するWPF印刷呼び出しをフックしました。 このフックは、XPS形式でディスクにすべてのジョブを書き込み、何もスプールせず、保存されたページ画像は調査ジョブと同じ1239 x 1754ピクセルでした。 IronPrintはその他の設定をジョブの印刷チケットに書き込みます。 Grayscaleがオンの時、チケットはモノクロ出力を要求しました。 ページ画像はRGBとして保存され、灰色のピクセルのみを保持していました。 チケットのコピー数はNumberOfCopiesから来ており、ジョブには各ページが1回ずつ保持されていました。

ラベルルートはフォールバックがジョブに何をするかを示します。 入力は標本ラベル__S-031.pdf、受信フォルダからの100 x 50 mmラベルであり、ルーティングファイルは300 DPIでPaperSize.PrinterDefaultを使用してLAB-ZEBRA-01に送信します。

出力

ラベルルートの設定は名前チェックなしで送信され、ジョブはMicrosoft Print to PDFにフォールバックしました。 そのプリンターのデフォルト用紙サイズはそのプリンターのA4シートに解決され、ラベルはA4ランドスケープページ上で1179 x 591ピクセルの画像になりました。 ジョブはその画像を297 x 149 mm、シート全幅にスケーリングしました。

IronPrintが名前チェックなしでジョブを構築したS-031標本ラベル。1 A4横向きページで、300 DPI、Microsoft Print to PDFに送られ、プリンターの代わりにファイルにキャプチャ。

コンパイルするIronPrintコードをどのように促すのか?

ルーターとそのレポートをプランモードで1つのプロンプトとして送信し、デザインが変更される前に合意されます。 ステータスバーがプランモードを表示するまでShift+Tabを押し、その後プロンプトを送信します。 opusplanの下では、プランはOpusから来て、Planが承認された後にSonnetが変更を加えます。

Build the router in Services/PrintRouter.cs and the report in Services/RoutingReport.cs.
Call both from Program.cs after the printer check.
Program.cs passes PrintRouter the list from one Printer.GetPrinterNames call.

Each PDF in inbox/ is named <documentType>__<id>.pdf.
For each file, PrintRouter does this:

1. Finds the route for its document type in config/printer-routes.json.
2. Checks the route's printer against that list.
3. Builds PrintSettings from the route's paper size, orientation, DPI, copies and grayscale.
4. Sends the job with Printer.PrintAsync, but only under --send.

Each file gets the first of these decisions that fits:

- send, when the printer name matches an installed name exactly.
- name-mismatch, when it matches one after ignoring case and outer spaces.
- not-installed, when nothing matches.
- no-route, when the config has no route for the type.

Only send files reach the print call.
Put that call behind an interface so tests can use a fake.

Write out/routing-report.csv with a header row and one row per file, sorted by file name.
Its first columns are File, DocumentType, ConfiguredPrinter, Decision and InstalledName.
Then come PaperSize, Orientation, Dpi, Copies and Grayscale from the route.
InstalledName holds the installed printer for send and the near match for name-mismatch.
It stays empty for the other two decisions.
A no-route row leaves the five route columns empty too.
Write Grayscale as true or false.
Print a count of files per decision.

Run the program without --send and show me the CSV.
Then have the printer-name-auditor subagent review Services/.
Text

プロンプトの2つの部分がルーティングを保護します。

  1. 送信フラグ:--sendなしでは、プログラムはジョブを送信せず、エージェントはダイアログを開くプリンターを持つマシンでルーターを実行しテストできます。
  2. 監査サブエージェント:カスタムサブエージェントはCLAUDE.mdをロードし、プリンター名ルールがそのレビューにも適用されます。 ビルトインエージェントのうち、ExploreとPlanはCLAUDE.mdをなしで開始します。
ヒント: プランを承認する前に、IronPrintに与えられた名前が正確なチェックからのインストール済みの名前であることを確認してください。 大文字小文字を無視して名前を一致させ、その後設定した名前を渡すプランでは、クーリエのマニフェストがデフォルトプリンターで送信されます。

ライセンスキーなしでIronPrintルーティングコードをテストできますか?

はい、テストが印刷呼び出しを置き換える場合に限り可能です。 ルーティングファイルの読み取り、インストールされたプリンターの一覧、およびPrintSettingsの構築はすべてキーなしで実行されるため、すべてのルーティング決定はキーがないビルドサーバーでテストできます。

Add a LabPrintRouter.Tests xUnit project that targets net9.0-windows.
It tests PrintRouter through a fake print sink.

The tests read the copies of inbox/ and config/ in their output folder.
Give the router a fixed printer list of "Adobe PDF", "Microsoft Print to PDF" and "Fax".
Assert these results:

- The decision for each of the 7 files.
- The fake receives the 2 result reports and nothing else.
- RPT-4471 goes out with A4, Portrait, 150 DPI, 1 copy and grayscale on.
- Printer.GetPrinterNames runs without throwing while no key is applied.

Set the project up this way:

- It lives in its own folder, and the repository root gets no solution file.
- LabPrintRouter.csproj must not compile anything in that folder.
- The test output folder gets copies of config/ and inbox/.

Run dotnet test one time, in a child process that has no IRONPRINT_LICENSE_KEY.
Tell me the pass count from that run.
Text

生成されたIronPrintコードを信頼する前に何を確認すべきですか?

生成されたIronPrintコードを次のチェックでレビューします。

  • ビルド:IronPrintにないメンバーがdotnet buildをコンパイルエラーで停止させます。 出荷されたIronPrint.xmlには内部PdfiumUtilsクラスのメソッドも文書化されており、それを呼び出すコードはCS0122で失敗します。
  • ルーティングレポート:最初の実際のジョブの前に、ルーティングファイルとインストールされたプリンターリストとそれぞれの決定を比較します。
  • プリンターあたり1つのテストページ:リリース前に、ルートが示す場所でテストページが印刷されたことを各デバイスで確認します。

AIコーディングアシスタントガイドは、繰り返し可能なテストとして、固定された合格基準を持つ完全なIronPrintタスクを提供します。

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

4つのプロンプトは1つのClaude Codeセッションで、示される順序で実行されました。 プロンプト3の前にはルールブロックがCLAUDE.mdに貼り付けられ、誰もコードを手動で編集しませんでした。

  • クイックスタートの出力は、インストールされたすべてのプリンターを名前で示し、1つのルートをインストール済み、3つを欠けているとマークしました。
  • ルーティングレポートには7つのファイルのそれぞれ1行が記載されていました。
  • 2つのファイルには送信、2つの名前不一致、2つはインストールされておらず、1つはルートなしとマークされていました。
  • すべての決定がインストールされたプリンターに対する独立したチェックと一致していました。
  • ほぼ一致していたのは、宅配便伝票にはAdobe PDF、病棟要約にはMicrosoft Print to PDFでした。
  • 新しいコピーでクリーンなリリースランが同じレポートを生成しました。
  • キーがない場合、プログラムはIsLicensedをFalseとして報告し、同じ7つの決定を行いました。
  • IRONPRINT_LICENSE_KEY変数なしのプロセスで10分の10のテストがパスしました。
  • サブエージェントはIronPrint.xmlに欠けているIronPrintメンバーを見つけませんでした。
  • サブエージェントは、正確なチェックの後に配置された1つのプリンター名の割り当てを見つけました。
  • 実行後、印刷キューは空であり、トランスクリプトには--sendを使用するコマンドはありませんでした。
  • 送信ジョブのキャプチャはAdobe PDFキューのための3つのA4縦ページを保持し、それぞれが1239 x 1754ピクセルの画像でした。
  • 各プロンプトが警告やエラーのないリリースビルドを残しました。
  • トランスクリプト、セッションファイル、およびリポジトリのスキャンではライセンスキーのコピーが見つかりませんでした。
  • 一部のステップはページと異なる方法で実行されました。 手動で入力された返信がプロンプト3のプランをヘッドレスで実行したため承認しました。 テストマシンのすべてのプリンターが「保存」ダイアログを開くため、ジョブは印刷されず、2つの送信ジョブはXPSにキャプチャされました。

ルーティングレポートの最初の送信行は、受信からの2ページの結果報告書であるresult-report__RPT-4471.pdfでした。

出力

キャプチャツールはこの行の設定をルーティングレポートからIronPrintに渡しました。 以下のPDFには変更なしでキャプチャされたページが両方含まれます。

結果報告書RPT-4471は実行のルーティングレポートから送信ジョブをIronPrintが構築しました。両ページとも150 DPIのA4縦向きで、プリンターの代わりにファイルにキャプチャされています。

Cursorもプランモードを持っており、Cursorガイドがそのプロンプト3を送信します。 Codexは、ChatGPT Codexガイドに示されるように、AGENTS.mdからプロジェクトのルールを読み込みます。これはCLAUDE.mdの対応物です。 この実行のClaude Codeバージョン、モデル、および合計時間は、テストマシンの横にある実行記録に表示されます。


トラブルシューティング


質問ありますか?

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

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

もっと読む

準備はできましたか?

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