IronWordをClaude Codeと一緒に使用する方法
毎年11月、保険会社は加入者に更新手紙を送ります。 コンプライアンスチームは手紙の文言について単一のWordテンプレートを管理し、名前、日付、保険料、カバーディテールは保険システムから取り寄せられます。 見た目が完成した結合済み手紙が、合併がうまくいったことを証明するわけではありません。 このガイドの背後にあるプローブでは、カバーローが空白のままになったり、参照番号が落ちたり、最初の顧客のデータが再利用された結合が例外なく終了しました。 Claude Codeは、Anthropicのエージェンティックコーディングツールで、コードベースを読み込み、ファイルを編集し、ターミナル、VS Code、JetBrains IDE、デスクトップアプリケーション、またはブラウザからコマンドを実行します。
IronWordは、辞書、データ行、またはデータセットを使用してDOCXテンプレート内のMERGEFIELDプレースホルダーを埋め、テーブル行の繰り返し部分もサポートします。 Microsoft Officeは必要ありません。マージ自体は数行のコードで行います。 呼び出しの順序とデフォルトオプションが出力が正しいかどうかを決定し、一部の間違いは例外を発生させずに誤った出力を生成します。 以下の4つのテストプロンプトは、Claude Codeを設定して更新手紙のバッチを生成し、それぞれのプロンプトに続いてIronWordの動作が続きます。
クイックスタートプロジェクトフォルダー内でclaudeを開始し、任意のプロンプトの前に/model opusplanを1度実行します。 パスの前の@はそのファイルの内容をリクエストに含めます。
Add the IronWord NuGet package, version 2026.10.4, to RenewalLetters.csproj.
Then write one renewal letter in Program.cs.
Merge the first customer row of @Data/customers.csv into @Templates/renewal-letter.docx.
Save the letter to out/letters/NM-104233.docx.
Create that folder first, and pass the path to the save call.
Don't change the template file.
Next, open the saved letter in a new WordDocument and print these in order:
1. The body text.
2. The text of every table cell, row by row, with each cell cast to TableCell to read it.
3. The names of any merge fields still in the document, or "none".
My license key is in the IRONWORD_LICENSE_KEY environment variable.
Have the program read that variable itself and apply the key before the first IronWord call.
Don't print, echo or save the key anywhere.
Don't list environment variables to look for it either.
Tell me whether it's set and nothing more.
本文の前にテーブル出力を確認してください。 カバーローは繰り返し領域にあり、その領域呼び出しによってのみ埋められます。
最小限のワークフロー(5ステップ)
- NuGetからC# Wordライブラリをダウンロード
- プロジェクトフォルダからClaude Codeを開き、/modelでモデルを設定します
- スターのIronWordのマージルールをCLAUDE.mdに記録して、すべてのセッションがそれらをロードするようにしてください
- 各データ行ごとに手紙を要求し、領域の行が他のフィールドの前に埋められるようにします
- 保存された各手紙を再度開き、元のデータに対してそのテキストと表セルを確認し、ヘッダーとフッターパーツを点検します
Claude Codeは、.NETのWordドキュメントプロジェクトで何をしますか?
Claude Codeはマージサービスを書き上げ、2つのCSVファイルからポリシーごとに1つの手紙を生成します。 その後、保存された各手紙を再度開いてチェックします。 検証が失敗すると、マージコードを修正してバッチを再実行します。 開発者が正しい手紙に含まれる内容を決定し、最後に監査ファイルを確認します。
IronWordパッケージとそのバージョンを最初のプロンプトで指定します。 攻撃者は、ハルシネーション中のパッケージ名で悪意のあるパッケージを登録します。この手法はスロップスクワッティングと呼ばれます。
Claude Codeをどのように設定しますか?
Anthropicのクイックスタートにはインストールとサインインが含まれています。 セットアップは、ターミナルでclaudeを開いて反応を待つことで完了します。
プロジェクトClaude Codeが作業できるようにするにはどうすればよいですか?
本ガイドで使用されたフィクスチャは、.NET 9コンソールアプリケーションをコンパイルし、マージフィールドが設定された更新手紙が入ったテンプレートフォルダー、そしてポリシー番号ごとにキーを持つ顧客CSVとカバーローのCSVが入ったデータフォルダーから成ります。
Claude Codeは各新しいセッションにCLAUDE.mdをロードするので、そのルールはその後のすべてのプロンプトに適用されます。クイックスタートでパッケージをインストールした後、2番目のプロンプトがそのファイルとマージコードのレビューアを作成します。
Create CLAUDE.md in the repository root and give it a section called Mail merge.
Every later session should find these rules in it:
- IronWord is the only DOCX library this project may use.
- The NuGet package is IronWord, at the version RenewalLetters.csproj references now.
- Look up IronWord member names in docs/IronWord.xml.
- Templates/ is read-only, and each letter starts from a new load of the template file.
- The license key rules from my first message, written out in full.
- A letter isn't finished until the saved file has been reopened and checked.
Copy docs/IronWord.xml now from the ironword folder of the local NuGet cache.
If the file isn't there, stop and say so.
Then add a subagent at .claude/agents/merge-auditor.md.
Give it the Read, Grep and Glob tools and no others.
Its job is to list every IronWord type and member used under Services/.
It should name each one that docs/IronWord.xml doesn't document.
IronSoftware.* types such as ITableCell are documented in other packages.
Have it list those separately, so it doesn't call them missing.
Claude Codeは新しいサブエージェントファイルを監視用にclaude/エージェントを監視しますが、監視対象は起動時に存在するフォルダーだけなので、セッションを開始する前にそのフォルダーを作成します。 メンバーリストを超えたドキュメントには、エージェントはIronWordのllms.txtから始めることができます。これは、ハウツーガイドやトラブルシューティングページにリンクしています。
最初の保存前にライセンスの対処をします。 キーがない場合、すべての保存呼び出しは「Production License Required」と読むLicensingExceptionをスローします。 これは、パスまたはストリームの有無にかかわらず、SaveとSaveAsに適用されます。 IronWord License Keysページでは、試用版と有料キー、およびコードまたは設定ファイルでの設定方法について説明しています。
CLAUDE.mdに属するIronWordのメールマージルールはどれですか?
フィクスチャテンプレートに対する調査は、IronWord 2026.10.4に対して各行をチェックし、最後の3つにはライセンスキーがありました。 メールマージセクションの下にブロックを追加します。
IronWord 2026.10.4 behaves this way in a mail merge:
- MailMerge.Execute(DataTable) merges the first row only.
- Merge each row into its own WordDocument, loaded fresh from the template file.
- A merge removes the fields it fills, so a second Execute on the same document changes nothing.
- Call ExecuteWithRegions before Execute.
- Execute removes any region it has no table for, because RemoveUnusedRegions defaults to true.
- That region's row then stays in the table with empty cells.
- A region table with no rows removes the region row and keeps the rest of the table.
- RemoveUnusedFields defaults to true, so a field with no matching key is deleted with no error.
- Compare GetFieldNames() with the data columns before merging.
- Field names match without regard to case unless CaseInsensitiveFieldNames is set to false.
- NullValueReplacement replaces DBNull values. An empty string merges as an empty string.
- WordDocument.ExtractText() returns body paragraphs only, joined with no separator.
- ExtractText() skips table cells, the header and the footer.
- Rows[i].Cells holds ITableCell values, which have no ExtractText().
- Cast each cell to TableCell before calling ExtractText() on it.
- GetFields() and GetFieldNames() don't see merge fields in the header.
- Save each letter with Save(outputPath).
- One troubleshooting page reports a header that SaveAs(outputPath) dropped and Save kept.
- Never call Save() with no argument. It overwrites the file the document was loaded from.
未使用フィールドルールは調査で最も目立たない失敗を生み出しました。 テンプレートには「リファレンス」その後に顧客ファイルに一致する列のないリファレンスコードフィールドが含まれ、デフォルトのマージは文を「リファレンス」に変更しました。 「私たちに電話する際はこの番号を引用してください。」例外を発生させることなく。
繰り返しテーブル行とWordテンプレートをマージするにはどうすればよいですか?
テンプレート内の繰り返し行に、同じリージョン名を持つ開始フィールドと終了フィールドをマークします。 フィクスチャテンプレートでは、カバーローはTableStart:Coveragesで始まり、TableEnd:Coveragesで終わります。 リージョン呼び出しは、名前がリージョンに一致するデータテーブルを受け入れ、各データ行ごとに1度行をコピーします。 次に、バリュー呼び出しは、辞書または単一データ行からリージョン外のすべてのフィールドを埋めます。
メールマージガイドは、各オーバーロードおよびマージオプションを文書化しています。
IronWordのコンパイルコードをプロンプトするにはどうすればよいですか?
マージャーとその監査結果を1つのプロンプトに入れ、計画モードで送信し、デザインがファイルの変更の前に確定されるようにします。 Shift+Tabで計画モードを選び、ステータスバーに表示されたらプロンプトを送信します。 opusplanでは、Opusが計画を手掛け、Sonnetが承認後にコードを書きます。
Build the batch in Services/LetterMerger.cs and Services/LetterAudit.cs.
Run both from Program.cs after the Quickstart letter.
LetterMerger reads @Data/customers.csv and @Data/coverages.csv.
For each customer it does this:
1. Loads Templates/renewal-letter.docx again.
2. Fills the Coverages region with that policy's rows, if any.
3. Fills the other fields from the customer row.
4. Saves out/letters/<PolicyNumber>.docx.
Before the first merge, it prints each template merge field with no column in either CSV.
LetterAudit opens each saved letter from disk and passes it when these all hold:
- Every customer value appears in the body text.
- The coverage table holds only that policy's rows, in CSV order.
- word/document.xml, read as a zip entry, has no merge field or MERGEFIELD instruction left.
For an empty customer value, check its whole sentence.
One case is the agent sentence with no phone number.
Two more columns don't count toward a pass:
- Header, from word/header1.xml: shows the policy number, still has the merge field, or is missing.
- Footer, from word/footer1.xml: matches the template's footer, changed, or is missing.
Write out/letter-audit.csv with one row per letter.
Print how many letters pass.
After the batch, run git status on Templates/ and tell me about any change.
Don't use a docx skill or rewrite any package XML by hand.
The audit can read parts as zip entries.
Keep fixing the merger until every letter passes.
If a header keeps its field, tell me whether any IronWord call reached it.
Then have the merge-auditor subagent review Services/.
プロンプトの2つの部分は、IronWordとClaude Codeの動作に依存します。
- 監査は保存されたパッケージを読み取ります:ヘッダーとフッターは抽出されたテキストまたはフィールドリストに含まれません。ヘッダーを埋めるIronWordのマージ呼び出しがないため、カウントに含めるとエージェントがプロンプトで禁止されたXML回避策に導くことになります。
- 読み取り専用レビューア:カスタムサブエージェントはCLAUDE.mdをロードし、ExploreとPlanを除くすべてのビルトインエージェントと同様にします。そのため、マージ監査はMail Mergeルールに対してServices/を確認します。
テンプレートを顧客ごとのループ内で読み込み、地域呼び出しを値の呼び出しの前に配置する場合にのみ計画を承認してください。
IronWordマージコードはライセンスキーなしでテスト可能ですか?
はい、テストが保存の前で止まる限り可能です。 テンプレートのロード、マージ、およびテキストを読み返すことはすべてライセンスなしで実行されるため、キーなしのビルドエージェントでもマージテストを実行できます。
Add a RenewalLetters.Tests xUnit project that tests LetterMerger without writing any file.
Merge NM-104267 and NM-104288 in memory.
Assert the body text and every coverage table cell against the CSV rows.
Cover the policy with no coverage rows and the agent sentence with an empty phone number.
A few things about the setup:
- Split the merge from the save in LetterMerger if a test needs that.
- Leave the license key unset when the variable is missing.
- Put the test project in its own folder, with no solution file at the repository root.
- Keep RenewalLetters.csproj from compiling the files in that folder.
- Have the test project copy Templates/ and Data/ to its output folder.
Run dotnet test on the test project once, in a child process with no IRONWORD_LICENSE_KEY variable.
Show me the tests passing without a key.
生成されたIronWordコードを信頼する前に何を確認すべきですか?
抽出された本文テキストへの含有テストで各値を比較してください、各段落はその間に改行がない状態で返されます。
レビューに3つのチェックを追加します。
- ビルド:
dotnet buildはIronWordに欠けているメンバー名に対して失敗します。 提供されるIronWord.xmlにも公開されていないメンバーがリストされているため、そこに見つかった名前はプローブ内で行われたように、CS1061で失敗する可能性があります。 - テンプレート:バッチ後にコミットされたコピーとそのテンプレートを比較します。 当社のライセンス付きプローブでは、引数なしの単一の保存がテンプレートを最初の顧客のマージ済み手紙に置き換えました。その結果、そのファイルの後続のロードには埋めるフィールドが含まれていませんでした。
- ヘッダー: ヘッダーのトラブルシューティングページでは、読者に自分の出力を開いてヘッダーを確認するよう指示します。 同じプローブは、すべての保存呼び出しがヘッダーとフッターをバイトごとに保存していることを見つけました。
AIコーディングアシスタントガイドには、固定された通過基準を持つ完全なIronWordタスクが含まれているため、すべての読者がそれを再実行できます。
プロンプトが実運用で生成したものは何ですか?
Claude Codeは4つのプロンプトを1つのセッションで順に実行しました。 メインマージブロックはプロンプト3の前にはCLAUDE.mdに入りました。コードは手動で編集されませんでした。 データは5人の顧客と10のカバーローを保持しました。 クリーンリリースリビルドは同じ監査ファイルを生成しました。当社のパッケージ検査は、すべての行に一致しました。
- クイックスタートの手紙、値のみでマージされ、ヘッダーローと空の行1つを保持しました。
- すべての5つのバッチ手紙は最初の監査をパスしました。
- 手紙は、CSVの如く3、1、4、0、2のカバーローを保持していました。
- プレフライトはデータ列のない1つのフィールドReferenceCodeを報告しました。
- ポリシーナンバーフィールドは5つのヘッダーすべてに留まりました。
- 各フッターはテンプレートと一致しました。
- プロセスからIRONWORD_LICENSE_KEYが欠けた状態で4分の4のテストがパスしました。
- サブエージェントは、IronWord.xmlから欠けているIronWordメンバーを見つけませんでした。
- テンプレートのハッシュはバッチ後も変わりませんでした。
- すべてのプロンプトは、クリーンリリースビルドで終了しました。
- ライセンスキーは、この実行のすべてのトランスクリプト、セッションファイル、リポジトリファイルから欠けていました。
- プロンプト1および4では、シェルテストはキーが設定されているかどうかのみを印刷しました。
- 一部のステップはページと異なる方法で実行されました。 セッションがヘッドレスで実行されたため、オペレーターは打ち込んだ返信でプロンプト3のプランを承認しました。 プロンプト3は、クイックスタートのSaveAs呼び出しをClaude.mdに従うためにSaveに変更しました。
Cursorガイドでは、Cursorもファイルを編集する前に計画を立て、計画を編集可能なファイルに書き込みます。 ChatGPT Codexガイドでは、Codex相当のCLAUDE.mdであるAGENTS.mdに恒常的な指示を保管します。
共有されたラン記録には、この実行のClaude Codeリリース、モデル、期間、およびテストマシンが記載されています。
トラブルシューティング
- メールマージWord文書をリージョンまたはフィールドが埋まらない場合
- SaveAs後に消えるヘッダーをマージされた手紙がヘッダーを失った場合
- web.config内のIronWordライセンス構成のキーが無視される場合
質問ありますか?
質問がある場合は、support@ironsoftware.com にお問い合わせください。
Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。