Claude Code ile IronPPT Nasıl Kullanılır

Curtis Chau
Curtis Chau
Güncellendi: 19 Ekim 2026

Bir eğitim şirketi, her C# kursu oturumu için bir PowerPoint el kitabı dağıtır. Her modül, konuların ana hatlarını, her konunun altındaki noktaları, kod örneklerini ve ara sıra uyarıları içeren bir taslak dosyaya ve her tür metnin yazı tipini, boyutunu ve konumunu sabitleyen bir ev stili dosyasına sahiptir. Desteler elle birleştirildiğinde, yanlış bir yazı tipi veya örtüşen bir metin kutusu, bir katılımcı el kitabını yazdırana kadar fark edilmeyebilir. Anthropic'in yazılım ajanı Claude Code, terminallerde, VS Code'da, JetBrains'de, masaüstü uygulamalarında ve web üzerinde çalışır. Her ortamda, depoları okur, dosyaları değiştirir ve komutları yürütür.

IronPPT, PowerPoint dosyaları oluşturan ve düzenleyen, Office Interop kullanmayan bir .NET kütüphanesidir. metin ekleme kılavuzunda gösterildiği gibi AddText bir slayda metin ekler ve TextStyle ağırlığını, yazı tipini ve boyutunu ayarlar. Dört test edilmiş talimat Claude Code'u kurar ve el kitabı jeneratörünü oluşturur. Her talimatın bağlı olduğu IronPPT metin davranışları yanında kaydedilir.

Hızlı Başlangıç
NuGetNuGet ile Yükle

PM > Install-Package IronPPT

Yukarıdaki komutu NuGet Paket Yöneticisi Konsolunda çalıştırarak veya NuGet Paket Yöneticisinde arama yaparak IronPPT'u yükleyin.

Proje klasöründe bir terminal açın, claude çalıştırın ve ilk talimatın öncesinde /model opusplan girin. @ ile başlayan bir yol, o dosyayı isteğe ekler.

Install IronPPT from NuGet, version 2026.10.1, in TrainingHandouts.csproj.
Then turn Program.cs into a smoke test built from @course/module-03-async.json.

Program.cs runs these steps in order:

1. Applies the key, then prints the value of License.IsLicensed.
2. Adds the module's title value to the first slide with Slide.AddText.
3. Saves the deck as out/smoke.pptx, creating out/ if it's missing.
4. Loads out/smoke.pptx again and prints how many slides it has.
5. Lists every text box on each slide, with its text in quotes.

The key is in the IRONPPT_LICENSE_KEY environment variable, and these rules cover it:

- Program.cs reads the variable at startup and copies the value into License.LicenseKey.
- Never log the key, print it, or write it to a file.
- Don't run any command that lists environment variables.
- If you need to check the variable, tell me only whether it's set.

Run the program once and tell me what it printed.
Text


Claude Code bir .NET sunum projesinde ne yapar?

Ajan jeneratörü yazar, taslak dosyalarını okur, her modül için bir güverte oluşturur ve kaydedilen her güverteyi stil dosyasıyla karşılaştırır. Bir kontrol başarısız olduğunda, ürettiği raporu okur, jeneratörü düzeltir ve tekrar çalıştırır. Geliştirici, ev stilini ve her slaydın metnini belirler.

İlk talimat IronPPT paketinin adını ve sürümünü belirtir. Bir paketin adını seçmesi bırakılan bir ajan, AI araçlarının ürettiği ancak gerçek bir paketin kullanmadığı bir ad altında bir saldırganın kayıt ettirdiği bir paketi yükleyebilir. Bu saldırı slopsquatting olarak bilinir.

Claude Code nasıl kurulur?

Anthropic'in hızlı başlangıcı takip edilerek Claude Code yüklensin ve giriş yapılsın. Bir terminalde claude başladığında ve cevap verdiğinde kurulum tamamlanmıştır.

Claude Code'un çalışabileceği bir proje nasıl kurulur?

İlk talimat öncesinde ajana gerçek girdiler verin. Test fikstürü, iki modül taslağını ve ev stil dosyasını barındıran bir kurs klasörüne sahip bir .NET 9 konsol uygulamasıdır. Modül 3 taslağı async ve await'i dört konuda kapsar ve modül 4 taslağı LINQ'u üç konuda kapsar. Stil dosyası, her biri yazı tipi, boyut, ağırlık, hizalama ve puan cinsinden bir kutu içeren yedi metin rolünü tanımlar.

CLAUDE.md her oturumun başında yüklenir, bu nedenle orada yazılan kurallar sonraki her talimata uygulanır. İkinci talimat, dosyayı ve jeneratör kodu için salt okunur bir değerlendirmeci oluşturur.

Write a CLAUDE.md for this repo.
Its Presentations section holds these rules for every later session:

- IronPPT is the only presentation library. Don't add the Open XML SDK or any other.
- Keep the IronPPT version that TrainingHandouts.csproj references now.
- Look up IronPPT member names in docs/IronPPT.xml before you use them.
- course/ holds the inputs. Leave every file in it as it is.
- Program.cs saves decks to out/, and each saved deck is opened again and checked.

Copy IronPPT.xml into docs/ now, from the ironppt 2026.10.1 package in the local NuGet cache.
It's under lib/netstandard2.0. If it's missing, tell me and keep going.

Next, add a subagent at .claude/agents/handout-layout-reviewer.md.
Its tools are Read, Grep and Glob, and no others.
It reviews Handouts/ and answers four questions:

- Which IronPPT types and members does the code use?
- Which of those are missing from docs/IronPPT.xml?
- Which text boxes reach a slide without a Position, Width and Height?
- Which style settings in the code does CLAUDE.md list as lost on save?

I'll add IronPPT's measured text rules to CLAUDE.md myself before the first review.
When you're done, tell me whether the XML copy worked.
Text

Claude Code, yeni bir alt ajan dosyasını yeniden başlatmadan tespit eder, verilmiş ki .claude/agents klasörü oturum başladığında mevcut olmalıdır. O klasörü oturum başlatılmadan önce depoda oluşturun. Üye listesinin ötesindeki kılavuzlar için, IronPPT ajanlar için belgelendirmesini llms.txt dosyasına listeler.

IronPPT metin kuralları CLAUDE.md dosyasına hangi kurallar ait?

Her satır, lisans anahtarı ile ve olmadan çalıştırılan bir prob kullanımından gelir, bu sırada kaydedilen her güverte, slayt XML'inden geri okunur. Bloku Sunumlar bölümünün altına yapıştırın.

These text rules were measured on IronPPT 2026.10.1:

- IronPPT doesn't read IRONPPT_LICENSE_KEY. Assign License.LicenseKey before the first save.
- Without a key, decks build and load, but Save throws LicensingException and writes no file.
- LicensingException isn't public, so catch (LicensingException) fails with CS0122.
- Match that exception by its type name instead.
- new PresentationDocument() already has one slide, holding an empty title and subtitle.
- A slide is 720 by 540 points.
- Slide.AddText writes a 150 by 100 point box with no position. Two calls overlap.
- Give every TextBox a Position, Width and Height. All three are in points.
- Set the typeface with Font.LatinFont. Font.FontFamily is never written to the file.
- Font.FontSize is in points.
- Align with Paragraph.Style = new ParagraphStyle { Alignment = TextAlignmentTypeValues.Center }.
- Paragraph.Alignment and Paragraph.SetAlignment write left alignment, even for Center or Right.
- Leave TextStyle.Color unset. Each colored run fails Open XML validation.
- new Color(r, g, b) makes Save throw NullReferenceException.
- An Underline writes no u attribute, so nothing is underlined.
- A line break inside one AddText string stays inside one run. Use a Paragraph per line.
- After a reload, font sizes, positions and box sizes read back at 12700 times the XML value.
- It also reports every alignment as Left after a reload.
- So check fonts, sizes, positions and alignment in the slide XML, not through IronPPT's reader.
Markdown

IronPPT, IronPPT.LicenseKey adını taşıyan bir ortam değişkenini kendi başına okur ve prob, IRONPPT_LICENSE_KEY'yi görmezden geldiğini buldu.

IronPPT bir slayda metni nereye yerleştirir?

Slide.AddText, 150x100 puanlık bir yeni şekil içine ve konumsuz olarak metni yazar. Metin ekleme kılavuzunun kendi ekran görüntüsü, ilk slaytta, "IronPPT!den Merhaba!"nın sol üstte dar bir kutuda üç satıra yayıldığı sonucu gösterir. Aynı slaytta her bir AddText çağrısı, konumsuz olarak aynı boyutta başka bir şekil yazar, bu nedenle şekiller üst üste biner.

Bir el kitabı, her tür metnin sabit bir yerde olmasına ihtiyaç duyar. TextBox, Position, Width ve Height'yı puan cinsinden kabul eder ve IronPPT onları kayma ve boyutlandırma olarak slayta yazar. Slaydın kendisi, 4x3 standart boyutunda 720x540 puandır, bu yüzden geniş ekran bir güverte için yazılmış bir stil dosyası uymayabilir.

Test çalışmasındaki modül 3 el kitabının başlık slaytı, stil dosyasından yerleşilmiş ve boyutlandırılmış üç başlık kutusunu gösterir.

Slayt XML'inden ölçekle çizilmiş modül 3 el kitabının başlık slaytı

Test çalışmasında IronPPT tarafından kaydedilen modül 3 el kitabının slayt 1'i. Yazı tipleri ve boyutları isimlendirilmiş olan bu slayt XML'inden ölçekle çizilmiştir. Kutu konturları, PowerPoint rendere edilmemiş bir çizim betiğinden gelir.

IronPPT tarafından yazılan her metin kutusu bir gövde yer tutucusudur. Gövde yer tutucularının takip ettiği slayt efendisinin gövde stili, bir madde işareti karakteri ve 32 noktalık varsayılan bir boyut tanımlar.

IronPPT dosyaya hangi metin stillerini yazar?

IronPPT, kalın, italik ve yazı tipi boyutunu dosyaya ayarlanmış olarak yazar. Prob, Font.FontFamily'yı Consolas olarak ayarladı ve çalışma özelliklerinde hiçbir yazı tipi bulamazken, Font.LatinFont yazı tipini yazdı.

Hizalama hangi üyenin ayarladığına bağlıdır. Paragraph.Alignment ve Paragraph.SetAlignment, ortalanmış bir paragrafı sola hizalı bıraktı. Paragraph.Style'ı ParagraphStyle ile TextAlignmentTypeValues.Center'e ayarlamak, ortalanmış hizalamayı yazdı. TextAlignmentTypeValues enum, IronPPT.Enums dışında, global ad alanında ilan edilir.

Adlandırılmış veya on altyedilik olan her renkli yürütme, Open XML SDK doğrulayıcısında başarısız oldu, çünkü IronPPT, rengi içinde yerine yana alfa ve kanal değerlerini yazar. Color(r, g, b) yapıcısı Save'nın NullReferenceException'ı atmasını sağladı. Bir Underline alt çizgi çizgi özelliklerini yazdı ama alt çizgiyle ilgili açma kapama özniteliğini yazmadı. IronPPT'nin kendi skill.md dosyası, kod parçacıklarında SetAlignment, renkli TextStyle ve alt çizgi kullanır, bu nedenle bu örnekleri kopyalayan bir ajan aynı sonuçları elde eder.

Derlenebilir IronPPT kodu için nasıl talep oluşturulur?

Jeneratör ve kontrolcüsünü tek bir talepte isteyin ve tasarımın tamamlanmasına herhangi bir dosya değişikliği öncesinde izin verin. Talebi göndermeden önce Shift+Tab ile plan moduna geçin. opusplan seçiliyken, Opus, planı yazar ve Sonnet plan onaylandıktan sonra onu uygular.

Build Handouts/HandoutBuilder.cs and its checker, Handouts/HandoutChecker.cs.
Have Program.cs run both.
Every JSON file in course/ except handout-style.json is a module.

HandoutBuilder follows these rules:

- Each module becomes out/<id>-handout.pptx.
- Another method builds a deck without saving it.
- Each box takes font, size, weight, alignment and box from the style role of the same name.
- Slide 1 is the document's own first slide, with course, title and trainer boxes.
- Each topic then gets a slide, in module file order.
- The title box reads "Module <module>: <title>".
- The trainer box reads "<trainer>, <date>", with the date unchanged.

Topic slides get these boxes:

- heading, the topic heading.
- point, one paragraph per point.
- code, if any, one paragraph per line, leading spaces kept.
- warning, if any.

HandoutChecker reads each saved deck's slide XML from the zip:

- It writes out/handout-check.csv, one row per paragraph, and skips empty shapes.
- It infers roles from the module file and box order.
- One method checks one deck file and returns its rows.
- Its columns are Module, Slide, Role, Text, Typeface, SizePt, Bold, Italic and Align.
- Then come X, Y, Width, Height and Match.
- Align is left, center or right. No algn attribute means left.
- Match is yes when text matches the module file and the rest matches the style file.

Run the program and tell me how many rows say no per module.
Then show me what the handout-layout-reviewer subagent finds.
Text

Talimatın iki bölümü, el kitaplarının doğru kalmasını sağlıyor.

  1. Tek kaynak olarak stil dosyası: Her yazı tipi, boyut, ağırlık, hizalama ve kutu tek bir dosyadan gelir, böylece kontrolcü, her paragrafı eğitmen tarafından yazılan bir değerle karşılaştırabilir.
  2. XML'i okuyan bir kontrolcü: Bir yeniden yüklemeden sonra, IronPPT, yazı tipi boyutunu, pozisyon ve kutu boyutunu 12.700 katı üzerinde rapor eder ve her hizalamayı sol olarak rapor eder. IronPPT okuyucusunun üzerine inşa edilen bir kontrol, doğru desteleri başarısız yapar.
İpuçları: Planı yalnızca her kutu yerleştirilmiş bir TextBox olduğunda ve her yazı tipi LatinFont aracılığıyla ayarlandığında onaylayın.

IronPPT el kitabı kodu bir lisans anahtarı olmadan test edilebilir mi?

Bellekte bir güverte oluşturmak ve kaydedilen bir güverteyi yüklemek, bir anahtar olmadan çalışır. Yalnızca kaydetmek bir anahtar gerektirir, bu nedenle bir test projesi, yapıya sahip bir ajanın üzerinde slayt yapısını ve kontrolcüyü kontrol edebilir.

Add an xUnit project, TrainingHandouts.Tests, for net9.0 in a folder of its own.
Keep that folder out of the TrainingHandouts.csproj build, and don't add a solution file.
Copy course/ and out/module-03-handout.pptx into the test output folder as test data.

The tests cover these cases:

- HandoutBuilder makes 5 slides for module-03 and 4 for module-04, with no save.
- The second code line on the last module-04 slide keeps its 4 leading spaces.
- Saving any deck with no key applied throws an exception whose type name is LicensingException.
- That failed save leaves no file at the target path.
- HandoutChecker finds 0 rows marked no in the copied deck.
- A changed heading typeface in a copy of that deck's slide XML gives exactly 1 row marked no.

Run dotnet test on TrainingHandouts.Tests once.
Use a child process with IRONPPT_LICENSE_KEY removed.
Tell me how many tests passed.
Text

Oluşturulmuş IronPPT koduna güvenmeden önce neyi doğrulamalısınız?

İnceleme sırasında aşağıdaki kontrolleri dahil edin.

  • Derleme: dotnet build var olmayan bir üyeyi reddeder. Gönderilen IronPPT.xml, üyelerin derlendiğine ve hala kaydetme üzerinde değerlerini kaybettiklerini belgeler, bu yüzden başarılı bir derleme yalnızca isimlerin var olduğunu kanıtlar.
  • Slayt XML: Her paragrafın yazı tipi, boyutu, hizalaması ve kutusunu stil dosyası ile karşılaştırın.
  • Bir basılı el kitabı: Kurs başlamadan önce, bir güverte basın ve hiçbir metin kutusunun bir başkasını örtmediğini doğrulayın.

Belirlenmiş geçiş kriterlerine sahip yeniden çalıştırılabilir bir tam IronPPT görevi için bkz AI kodlama yardımcıları kılavuzu.

Gerçek bir çalıştırmada istemler ne üretti?

Claude Code, dört talimatı bir oturumda sırayla çalıştırdı. Kurallar bloğu, talimat 3'ten önce CLAUDE.md içine gitti. Hiçbir kod elle düzenlenmedi.

  • Çalışmadan önce, depo kurs klasörü ve tek satırlık Program.cs içeriyordu, paket referansı yoktu.
  • Hızlı Başlangıç destesi, üç metin kutusu ile 1 slayta sahipti, bunların ikisi boş başlık ve altyazı yer tutucularıydı.
  • CLAUDE.md beş proje kuralını aldı ve alt ajan dosyası yalnızca Okuma, Grep ve Glob araçlarını listeliyordu.
  • Talimat 3'ten sonra, modül 3 el kitabı 5 slayta, modül 4 el kitabı 4 slayta sahipti.
  • Tüm 26 metin kutusu, stil dosyasının verdiği konum ve boyuta sahipti.
  • Slayt XML kontrolümüzde, tüm 38 paragraf, yazı tipi, boyut, ağırlık ve hizalamada stil dosyası ile eşleşti.
  • Kontrolcünün raporu 38 satır içeriyordu ve hiçbir satır işaretli değildi.
  • Claude Code'un talimat 3 özeti, rapor dosyasının içerdiğinden bir satır eksik olan 37 satır verdi.
  • Dört boşlukla başlayan kod satırı ve vurgu isimli eğitmen adı, slaytlarda değişmeden göründü.
  • Her iki el kitabı, 0 hata ile Open XML SDK doğrulayıcısından geçti.
  • Jeneratör, her kutuyu yerleştirilmiş bir TextBox olarak yarattı ve asla AddText çağrısı yapmadı.
  • Alt ajan, konumsuz bir metin kutusu bulmadı ve kurallar listesinde kaybolmuş olarak belirlenmiş bir ayar bulmadı.
  • [6/6] testler, IRONPPT_LICENSE_KEY olmadan bir süreçte ve yine taze bir klonda geçti.
  • Taze klonda bir Release çalışması, aynı iki el kitabını ve aynı 38 satırı üretti.
  • Anahtar olmadan, program her iki modülü de atladı ve başlık ve satır içermeyen bir rapor yazdı.
  • Lisans anahtarı, bu çalışmadaki hiçbir transkripte, oturum dosyasına veya depo dosyasına görünmedi.
  • Bazı adımlar sayfadan farklı çalıştı. Oturum başsız çalıştı, bu yüzden plan yanıtta göründü ve yazılı bir yanıtla onaylandı. Çalışmanın bekçisi, ajanın deposun içinde kalmasını sağladı, kullanıcı profiline kaydetmeye çalıştığı plan dosyasını engelledi.

Modül 3 el kitabında, slayt 3, ikinci konuyu, iki noktası ve üç satırlık koduyla tuttu.

Slayt XML'inden ölçekle çizilmiş modül 3 el kitabının slayt 3'ü

Test çalışmasında IronPPT tarafından kaydedilen modül 3 el kitabının slayt 3'ü. Yazı tipleri ve boyutları isimlendirilmiş olan bu slayt XML'inden ölçekle çizilmiştir. Kutu konturları, PowerPoint'le rendere edilmemiş bir çizim betiğinden gelir.

Cursor kılavuzu ayrıca ajanın önce bir plan yazmasını sağlar, Cursor bunu düzenlenebilir bir Markdown dosyası olarak kaydeder. ChatGPT Codex kılavuzu, güverte kurallarını AGENTS.md dosyasında tutar, Codex herhangi bir işe başlamadan önce okur, bu kılavuz CLAUDE.md ile olduğu gibi. Bu çalışmanın Claude Code sürümü, modelleri, zamanlamaları ve test makinesi, paylaşılan çalışma kaydında yer alıyor.


Hata Ayıklama


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.

Daha Fazla Oku

Başlamaya Hazır mısınız?

NuGet İndirmeleri 7,110Sürüm:2026.11yeni çıktı