Wie man IronWord mit Claude Code verwendet

Curtis Chau
Curtis Chau
Aktualisiert: 19. Oktober 2026

Jeden November sendet ein Versicherer Erneuerungsschreiben an seine Versicherungsnehmer. Das Compliance-Team verwaltet eine einzige Word-Vorlage für den Wortlaut des Schreibens, während Namen, Daten, Prämien und Deckungsdetails aus dem Versicherungssystem stammen. Ein zusammengeführtes Schreiben, das vollständig aussieht, beweist nicht, dass die Zusammenführung funktionierte. In den in diesem Leitfaden beschriebenen Tests verliefen Zusammführungen, die eine leere Deckungszeile hinterließen, eine Referenznummer entfernten oder die Daten des ersten Kunden erneut nutzten, ohne eine Ausnahme abzuschließen. Claude Code, das agentische Codierungstool von Anthropic, liest eine Codebasis, bearbeitet Dateien und führt Befehle von einem Terminal, VS Code, einer JetBrains IDE, der Desktop-App oder einem Browser aus.

IronWord füllt in DOCX-Vorlagen MERGEFIELD-Platzhalter mithilfe von Wörterbüchern, Datenzeilen oder Datenmengen aus und unterstützt wiederholende Bereiche für Tabellenzeilen. Es erfordert kein Microsoft Office. Die Zusammenführung selbst benötigt nur einige Codezeilen. Die Reihenfolge der Aufrufe und die Standardoptionen bestimmen, ob die Ausgabe korrekt ist, und einige Fehler erzeugen falsche Ausgaben, ohne eine Ausnahme auszulösen. Die vier getesteten Eingaben unten richten Claude Code so ein, dass es eine Charge von Erneuerungsschreiben produziert, und jedes von ihnen ist gefolgt von dem IronWord-Verhalten, auf das es sich stützt.

Schnellstart
NuGetMit NuGet installieren

PM > Install-Package IronWord

Installieren Sie IronWord, indem Sie den obigen Befehl in der NuGet Packet Manager-Konsole ausführen, oder suchen Sie das Paket im NuGet Paket Manager.

Starten Sie claude im Projektordner und führen Sie /model opusplan einmal aus, bevor irgendeine Eingabe erfolgt. Ein @ vor einem Pfad schließt den Inhalt dieser Datei in die Anforderung ein.

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.
Text

Überprüfen Sie die Tabellenausgabe vor dem Haupttext. Die Deckungszeilen befinden sich in einem wiederholenden Bereich, der nur durch den Bereichsaufruf ausgefüllt wird.



Was macht Claude Code in einem .NET Word-Dokument-Projekt?

Claude Code schreibt den Zusammenführungsdienst und produziert ein Schreiben pro Police aus den beiden CSV-Dateien. Anschließend öffnet es jedes gespeicherte Schreiben erneut und überprüft es. Wenn eine Prüfung fehlschlägt, überarbeitet es den Zusammenführungscode und führt die Charge erneut aus. Der Entwickler entscheidet, was ein korrektes Schreiben enthalten soll, und überprüft die Audit-Datei am Ende.

Benennen Sie das IronWord-Paket und dessen Version in der ersten Eingabe. Angreifer registrieren bösartige Pakete unter den Paketnamen, die Sprachmodelle halluzinieren, eine Technik, die als slopsquatting bezeichnet wird.

Wie richten Sie Claude Code ein?

Anthropics Schnellstart behandelt die Installation und Anmeldung. Die Einrichtung ist abgeschlossen, sobald claude in einem Terminal geöffnet und beantwortet wird.

Wie richten Sie ein Projekt ein, in dem Claude Code arbeiten kann?

Legen Sie echte Eingaben zuerst im Repository ab. Die in diesem Leitfaden verwendete Einrichtung besteht aus einer .NET 9-Konsolenanwendung, die kompiliert wird, einem Vorlagenordner, der das Erneuerungsschreiben mit seinen Zusammenführungsfeldern enthält, und einem Datenordner mit einer CSV-Datei der Kunden und einer der Deckungszeilen, die nach Policennummern geordnet sind.

Claude Code lädt CLAUDE.md in jede neue Sitzung, sodass dessen Regeln auf alle späteren Eingaben angewendet werden. Nachdem der Schnellstart das Paket installiert hat, erstellt eine zweite Eingabe diese Datei und einen Prüfer für den Zusammenführungscode.

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.
Text

Claude Code überwacht .claude/agents auf neue Subagentendateien, aber der Überwacher deckt nur Ordner ab, die beim Start vorhanden sind, erstellen Sie diesen Ordner also vor Beginn der Sitzung. Für Dokumentationen über die Mitgliederliste hinaus können Agenten bei IronWord's llms.txt beginnen, das die Anleitungen und Problemlösungsseiten verlinkt.

Behandeln Sie die Lizenzierung vor dem ersten Speichern. Ohne einen Schlüssel erzeugt jeder Speicheraufruf eine LicensingException, die "Production License Required" liest. Dies gilt für Save mit oder ohne Pfad oder Stream sowie für SaveAs. Die IronWord Lizenzschlüssel Seite behandelt Test- und bezahlte Schlüssel und wie man einen im Code oder in einer Konfigurationsdatei setzt.

Welche IronWord-Zusammenführungsregeln gehören in CLAUDE.md?

Ein Test mit der Vorlagenvorlage überprüfte jede Zeile mit IronWord 2026.10.4, mit einem Lizenzschlüssel für die letzten drei. Fügen Sie den Block unter dem Abschnitt Serienbrief hinzu.

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.
Markdown

Die Regel für ungenutzte Felder erzeugte den am wenigsten sichtbaren Fehler in den Tests. Die Vorlage enthält "Referenz" gefolgt von einem Referenzcode-Feld ohne entsprechende Spalte in der Kundenakte, und die Standardzusammenführung änderte den Satz in "Referenz. Zitat Sie diese Nummer, wenn Sie uns anrufen." ohne eine Ausnahme auszulösen.

Wie führt man eine Wortvorlage mit wiederholenden Tabellenzeilen zusammen?

Markieren Sie die wiederholende Zeile in der Vorlage mit einem Startfeld und einem Endfeld, die einen Bereichsnamen teilen. In der Vorlagenvorlage beginnt die Deckungszeile mit TableStart:Coverages und endet mit TableEnd:Coverages. Der Bereichsaufruf akzeptiert eine Datentabelle, deren Name mit dem Bereich übereinstimmt, und kopiert die Zeile einmal für jede Datenzeile. Der Wertaufruf füllt dann jedes Feld außerhalb des Bereichs aus einem Wörterbuch oder einer einzigen Datenzeile.

Der Serienführungsleitfaden dokumentiert jede Überladung und Zusammenführungsoption.

Wie fragen Sie nach IronWord-Code, der kompiliert?

Der Zusammenschluss und sein Audit gehen in eine Eingabe, die im Planmodus gesendet wird, sodass das Design festgelegt ist, bevor irgendwelche Dateiänderungen vorgenommen werden. Wechseln Sie mit Shift+Tab in den Planmodus und senden Sie die Eingabe, sobald die Statusleiste dies anzeigt. Mit opusplan behandelt Opus den Plan und Sonnet schreibt den Code nach Genehmigung.

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/.
Text

Zwei Teile der Eingabe hängen davon ab, wie IronWord und Claude Code sich verhalten.

  1. Das Audit liest das gespeicherte Paket: Der Kopf- und Fußzeile sind nicht im extrahierten Text oder der Feldliste enthalten. Ihre Spalten sind von der Zählung ausgeschlossen, da kein IronWord-Zusammenführungsaufruf den Kopfbereich füllt, sodass die Zählung den Agenten zur XML-Problemumgehung führen würde, die die Eingabe verbietet.
  2. Ein schreibgeschützter Prüfer: benutzerdefinierte Subagenten laden CLAUDE.md, ebenso wie alle eingebauten Agenten außer Explore und Plan, sodass der Merg-Auditor Services/gegen die Serienbrief-Regeln prüft.
Tipps: Genehmigen Sie den Plan nur, wenn er die Vorlage innerhalb der pro-Kunden-Schleife lädt und den Bereichsaufruf vor dem Wertaufruf platziert. Ein Plan, der die Vorlage einmal lädt, produziert fünf Kopien des ersten Schreibens.

Kann IronWord-Zusammenführungscode ohne Lizenzschlüssel getestet werden?

Ja, solange der Test vor dem Speichern stoppt. Das Laden der Vorlage, ihre Zusammenführung und das Zurücklesen des Textes laufen unlizenzziert, sodass ein Build-Agent ohne Schlüssel die Zusammenführungstests dennoch durchführen kann.

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.
Text

Was sollten Sie überprüfen, bevor Sie generierten IronWord-Code vertrauen?

Vergleichen Sie jeden Wert mit einem enthält-Test auf dem extrahierten Haupttext, da dessen Absätze ohne Zeilenumbrüche zwischen ihnen zurückgegeben werden.

Fügen Sie der Überprüfung drei Prüfungen hinzu.

  • Der Build: dotnet build schlägt bei jedem Mitgliedsnamen fehl, den IronWord nicht hat. Das gelieferte IronWord.xml listet auch nicht öffentliche Mitglieder auf, sodass ein dort gefundener Name immer noch mit CS1061 fehlschlagen kann, wie das bei zwei WordDocument-Mitgliedern im Test der Fall war.
  • Die Vorlage: vergleichen Sie sie nach der Charge mit ihrer festgelegten Kopie. In unserem lizenzierten Test ersetzte ein einzelnes Speichern ohne Argument die Vorlage mit dem zusammengeführten Schreiben des ersten Kunden, sodass jeder nachfolgende Ladevorgang dieser Datei keine Felder mehr zum Ausfüllen enthielt.
  • Der Kopfbereich: die Kopfbereich-Fehlerbehebungsseite fordert die Leser auf, ihre eigene Ausgabe zu öffnen und den Kopfbereich zu überprüfen. Der gleiche Test fand heraus, dass jeder Speicheraufruf den Kopf- und Fußzeilen bytegenau bewahrte.

Der AI-Programmierassistentenleitfaden hält eine vollständige IronWord-Aufgabe, deren Erfolgskriterien festgelegt sind, sodass jeder Leser sie erneut durchführen kann.

Was haben die Aufforderungen in einem realen Lauf erzeugt?

Claude Code lief die vier Prompts in einer Sitzung in der Reihenfolge ab. Der Serienbrief-Block kam vor Eingabe 3 in CLAUDE.md auf. Kein Code wurde manuell bearbeitet. Die Daten umfassten fünf Kunden und zehn Deckungszeilen. Ein sauberes Freigabe-Wiederaufbauverfahren erzeugte die gleiche Audit-Datei. Unsere Paketinspektion entsprach jeder Zeile.

  • Das Schnellstart-Schreiben, nur mit Werten zusammengeführt, behielt die Kopfbereichszeile und eine leere Zeile.
  • Alle 5 Chargenschreiben bestanden den ersten Audit.
  • Die Schreiben enthielten 3, 1, 4, 0 und 2 Deckungszeilen, wie in der CSV.
  • Die Vorflug überprüfen berichtete ein Feld ohne Daten-Spalte, ReferenceCode.
  • Das Polizistennummer-Feld blieb in allen 5 Köpfen bestehen.
  • Jedes Footer passte zur Vorlage.
  • 4 von 4 Tests bestanden ohne den IRONWORD_LICENSE_KEY im Prozess.
  • Der Subagent fand kein fehlendes IronWord-Mitglied in IronWord.xml.
  • Der Hash der Vorlage war nach der Charge unverändert.
  • Jede Eingabe endete mit einem sauberen Freigabe-Build.
  • Der Lizenzschlüssel war in keinem Transkript, keiner Sitzungsdatei und keiner Repository-Datei dieses Laufs vorhanden.
  • In Eingaben 1 und 4 druckte ein Shell-Test nur, ob der Schlüssel gesetzt war.
  • Einige Schritte liefen anders als die Seite. Da die Sitzung kopflos durchgeführt wurde, genehmigte der Operator die Eingabe 3-Plan mit einer getippten Antwort. Eingabe 3 änderte den SaveAs-Aufruf des Schnellstarts in Save, um CLAUDE.md zu folgen.

Im Cursor-Leitfaden plant Cursor auch, bevor es eine Datei bearbeitet, und es schreibt den Plan in eine bearbeitbare Datei. Der ChatGPT-Codex-Leitfaden speichert seine Standardanweisungen in AGENTS.md, das Codex-Gegenstück zu CLAUDE.md.

Der gemeinsame Laufbericht gibt diese Laufzeitversion von Claude Code, Modelle, Dauer und Testmaschine an.


Fehlerbehebung


Fragen?

Wenn Sie Fragen haben, wenden Sie sich an support@ironsoftware.com.

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.

Mehr lesen

Bereit loszulegen?

NuGet-Downloads 62,392Version:2026.11gerade veröffentlicht