IronWord ile Claude Code'u Nasıl Kullanırsınız
Her Kasım ayında, bir sigortacı poliçe sahiplerine yenileme mektupları gönderir. Uyum ekibi, mektubun kelime yapısı için tek bir Word şablonunu yönetir ve isimler, tarihler, primler ve kapsam detayları poliçe sisteminden alınır. Tamam gibi görünen birleştirilmiş bir mektup, birleştirmenin çalıştığını kanıtlamaz. Bu kılavuzun arkasındaki araştırmalarda, birleştirme boş bir kapsam satırı bıraktığında, bir referans numarası düştüğünde veya ilk müşterinin verilerini tekrar kullandığında hepsinde bir istisna olmadan sonuçlandı. Anthropic'in acente kodlama aracı olan Claude Code, bir kod tabanını okur, dosyaları düzenler ve bir terminalden, VS Code'dan, bir JetBrains IDE'den, masaüstü uygulamasından veya bir tarayıcıdan komut çalıştırır.
IronWord, sözlükleri, veri satırlarını veya veri setlerini kullanarak DOCX şablonlarındaki MERGEFIELD yer tutucularını doldurur ve tablo satırları için tekrarlayan bölgeleri destekler. Microsoft Office gerektirmez. Birleştirme işlemi birkaç satır kodda gerçekleşir. Çağrıların sırası ve varsayılan seçenekler çıktının doğru olup olmadığını belirler ve bazı hatalar bir istisna olmadan yanlış çıktı üretir. Aşağıda test edilen dört mesaj, Claude Code'u bir dizi yenileme mektubu üretmeye hazırlar ve her biri, dayandığı IronWord davranışı ile takip edilir.
Hızlı BaşlangıçProje klasöründe claude başlatın ve herhangi bir istemden önce /model opusplan bir kez çalıştırın. Bir yolu içeren bir @, isteğe o dosyanın içeriğini dahil eder.
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.
Gövde metninden önce tablo çıktısını inceleyin. Kapsam satırları bir tekrarlayan bölgededir ve yalnızca bölge çağrısı tarafından doldurulur.
Asgari İş Akışı (5 adım)
- NuGet'ten C# Word kütüphanesini indirin
- Proje klasöründen Claude Code'u açın ve modeli /model ile ayarlayın
- IronWord'un birleştirme kurallarını CLAUDE.md'ye kaydedin, böylece her oturum onları yükler.
- Her veri satırı için bir mektup isteyin, bölge satırlarının diğer alanlardan önce doldurulması ile.
- Her kaydedilen mektubu yeniden açın, metnini ve tablo hücrelerini kaynak verilerle karşılaştırın ve başlık ve alt bilgi parçalarını inceleyin.
.NET Word belge projesinde Claude Code ne yapar?
Claude Code birleştirme hizmetini yazar ve iki CSV dosyasından her poliçe için bir mektup üretir. Daha sonra her kaydedilen mektubu yeniden açar ve kontrol eder. Bir kontrol başarısız olduğunda, birleştirme kodunu gözden geçirir ve grubu yeniden çalıştırır. Geliştirici, doğru bir mektubun neler içermesi gerektiğine karar verir ve sonunda denetim dosyasını gözden geçirir.
İlk mesajda IronWord paketini ve sürümünü isimlendirin. Saldırganlar, dil modellerinin hayal ettiği paket adları altında kötü amaçlı paketler kaydeder, bu teknik slopsquatting olarak adlandırılır.
Claude Code nasıl kurulur?
Anthropic'in hızlı başlangıç rehberi kurulumu ve oturum açmayı kapsar. Açıldığında ve yanıt verdiğinde kurulum tamamlanır, claude bir terminalde.
Claude Code'un çalışabileceği bir proje nasıl kurulur?
Önce gerçek girdileri deposuna yerleştirin. Bu kılavuzda kullanılan öge, çalışan bir .NET 9 konsol uygulamasından oluşur, bir Bazı Mektup şablonunu içeren bir Şablonlar klasörü ve bir CSV müşterileri ve bir tane de poliçe numarasına göre anahtarlanmış kapsam satırları olan bir Veri klasörü.
Claude Code, CLAUDE.md'yi her yeni oturumda yükler, bu nedenle kuralları daha sonraki tüm isteklere uygulanır. Hızlı Başlangıcı, paketi yükledikten sonra ikinci bir istem oluşturur ve birleştirme kodu için bir değerlendirici.
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, yeni alt ajan dosyaları için .claude/agents klasörünü izler, ancak izleyici yalnızca başlatmada mevcut olan klasörleri kapsar, bu yüzden oturumu başlatmadan önce o klasörü oluşturun. Üye listesi dışında belgelendirme için, ajanlar llms.txt adlı IronWord rehberini başlatabilirler, bu, nasıl yapılır rehberlerini ve sorun giderme sayfalarına bağlantı içerir.
İlk kayıttan önce lisanslamayı adresleyin. Bir anahtar olmadan, her kayıtlama çağrısı "Üretim Lisansı Gerekli" metni ile bir LicensingException atar. Bu, bir yol veya akış olmadan Save ve SaveAs için de geçerlidir. IronWord Lisans Anahtarları sayfası, deneme ve ücretli anahtarları ve birini kodda veya bir yapılandırma dosyasında nasıl ayarlayacağınızı kapsar.
Hangi IronWord mail birleştirme kuralları CLAUDE.md'de yer alır?
Fikstür şablonu üzerindeki bir araştırma, her satırı IronWord 2026.10.4'e karşı kontrol etti ve son üç sürüm için bir lisans anahtarı ile. Mail birleştirme bölümünün altına bloğu ekleyin.
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.
Kullanılmayan alan kuralı, araştırmalarda en az görünen hatayı üretti. Şablon, müşteri dosyasında eşleşen sütun olmayan bir referans-kod alanı ile "Referans" içerir ve varsayılan birleştirme cümleyi "Referans ." olarak değiştirdi. Bizi aradığınızda bu numarayı belirtin." istisna atmadan.
Bir Word şablonunu tekrarlayan tablo satırlarıyla nasıl birleştirirsiniz?
Şablondaki tekrarlayan satırı, bir bölge adı paylaşan bir başlangıç alanı ve bir bitiş alanı ile işaretleyin. Fikstür şablonunda, kapsam satırı TableStart:Coverages ile başlar ve TableEnd:Coverages ile biter. Bölge çağrısı, adı bölgeyle eşleşen bir veri tablosunu kabul eder ve her veri satırı için satırı bir kez kopyalar. Daha sonra değer çağrısı, bölge dışında kalan her alanı bir sözlük veya tek bir veri satırından doldurur.
mail birleştirme rehberi, her aşırı yükleme ve birleştirme seçeneğini belgeler.
Derlenebilir IronWord kodu nasıl tetiklenir?
Birleştirme ve onun denetimi tek bir istekte yer alır, dosya değişikliklerinden önce tasarımın yerleşmesi için plan modunda gönderilir. Plan moduna geçmek ve durum çubuğu onu gösterdiğinde istemi göndermek için Shift+Tab ile döngü yapın. opusplan ile Opus planı ele alır ve Sonnet onaydan sonra kodu yazar.
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/.
İki parça, IronWord'un ve Claude Code'un nasıl davrandığına bağlıdır.
- Denetim, kaydedilen paketi okur: başlık ve alt bilgi, çıkarılan metin veya alan listesinde yer almaz. Alan çağrısındaki sayım başlığa hiç bir IronWord birleştirme çağrısı ile dolmadığı için, bunları dahil etmez, çünkü sayılacak olursa, isteği XML geçici çözümü ile çözecek ve mesaj yasağı istila edecektir.
- Salt okunur bir değerlendirici: özelleştirilmiş altjantlar CLAUDE.md'yi yükler, Tüm yerleşik ajanlar dışında Keşif ve Plan, bu nedenle birleştirme-denetleyici Hizmetler/mail birleştirme kuralları ile değerlendirir.
IronWord birleştirme kodu bir lisans anahtarı olmadan test edilebilir mi?
Evet, test kayıttan önce durduğu sürece. Şablonu yüklemek, birleştirmek ve metni geri okumak, tümü lisanssız çalışır, dolayısıyla bir anahtar olmadan bir oluşturma aracı, birleştirme testlerini yine de çalıştırabilir.
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.
Üretilen IronWord koduna güvenmeden önce neyi doğrulamalısınız?
Her değeri, çıkarılan gövde metni üzerinde bir içerme testiyle karşılaştırın, çünkü paragrafları aralarında satır sonları olmadan döndürülür.
İncelemeye üç kontrol ekleyin.
- Oluşturma:
dotnet build, IronWord'da olmayan herhangi bir üye adı üzerinde başarısız olur. Gönderilmiş IronWord.xml ayrıca public olmayan üyeleri listelediğinden, orada bulunan bir ad yine de CS1061 ile başarısız olabilir, araştırmada olduğu gibi iki WordDocument üyesi başarısız oldu. - Şablon: toplu işlemin ardından, bağlı kopyası ile karşılaştırın. Lisanslı araştırmamızda, bir argüman olmadan kaydedilen tek bir kayıt, şablonu ilk müşterinin birleştirilen mektubu ile değiştirdi, bu nedenle o dosyanın her sonraki yüklemesi doldurulacak hiçbir alan içermiyordu.
- Başlık: başlık sorun giderme sayfası okuyuculara kendi çıktılarında başlığı açmalarını ve kontrol etmelerini söylüyor. Aynı araştırma, her kayıt çağrısının başlık ve alt bilgiyi bayt bayt koruduğunu buldu.
AI kodlama yardımcıları rehberi, alan filtreleme kriterleri sabit olan bir IronWord görevini içerir, bu nedenle herhangi bir okuyucu onu tekrar çalıştırabilir.
Gerçek bir çalıştırmada istemler ne üretti?
Claude Code, dört talimatı bir oturumda sırayla çalıştırdı. Mail birleştirme bloğu, 3. istemden önce CLAUDE.md'ye yerleştirildi. Hiçbir kod el ile düzenlenmedi. Veriler beş müşteri ve on kapsam satırı içeriyordu. Temiz bir Sürüm yeniden kurulum aynı denetim dosyasını üretti. Paket incelememiz her satırla eşleşti.
- Fast Start mektubu yalnızca değerlerle birleştirildi ve başlık satırı ile bir boş satır korundu.
- Tüm 5 toplu mektup ilk denetimi geçti.
- Mektuplar, CSV'deki gibi 3, 1, 4, 0 ve 2 kapsam satırı içeriyordu.
- Yol öncesi bilgi boş veri sütununa sahip bir alan bildirdi, Referans Kodu.
- Poliçe numarası alanı tüm 5 başlıkta kalmıştır.
- Her alt bilgi, şablonla eşleşti.
- 4 testten 4'ü, işlemde IRONWORD_LICENSE anahtarının yokluğunda geçti.
- Altjant, IronWord.xml'den eksik hiçbir IronWord üyesi bulamadı.
- Toplu işlemden sonra şablonun hashi değişmedi.
- Her istem temiz bir Sürüm derlemesi ile sona erdi.
- Lisans anahtarı, bu çalışmanın hiçbir transkriptinde, oturum dosyasında veya depo dosyasında yoktu.
- İstem 1 ve 4'te, bir kabuk testi yalnızca anahtarın ayarlanıp ayarlanmadığını yazdırdı.
- Bazı adımlar sayfadan farklı çalıştı. Oturum başsız çalıştığı için, operatör 3. istem planını yazılı bir yanıtla onayladı. İstem 3, Hızlı Başlangıç'ın SaveAs çağrısını save olarak değiştirdi ve CLAUDE.md'yi izledi.
İmleç rehberinde, İmleç herhangi bir dosyayı düzenlemeden önce de planlar ve taslağı düzenlenebilir bir dosyaya yazar. ChatGPT Codex rehberi sürekli talimatlarını AGENTS.md'de depolar, CLAUDE.md'nin Codex karşılığıdır.
Paylaşılan çalıştırma kaydı, bu çalışmanın Claude Code sürümünü, modellerini, süresini ve test makinesini sağlar.
Hata Ayıklama
- Mail Birleştirme Word Belgeleri, bir bölge veya alan dolmazsa
- Kaydettiğinde Başlık Kayboluyor, bir birleştirilen mektup başlığını kaybederse
- IronWord Lisansı web.config'de, yapılandırmada anahtar göz ardı edilirse
Sorular?
Herhangi bir sorunuz varsa, support@ironsoftware.com adresinden bize ulaşın
Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.