Jak używać IronPPT z Claude Code
Firma szkoleniowa wydaje materialy PowerPoint na kazda sesje kursu C#. Kazdy modul ma plik z zarysem tematow, punktow pod kazdym tematem, przykladami kodu i ewentualnym ostrzezeniem, a plik stylu domowego ustawia czcionke, rozmiar i pozycje kazdego rodzaju tekstu. Gdy talie są montowane ręcznie, jedna zła czcionka lub jedno nakładające się pole tekstowe mogą pozostać niezauważone, aż do momentu, gdy stażysta wydrukuje materiały. Claude Code, agent oprogramowania Anthropic, dziala w terminalach, VS Code, JetBrains, aplikacjach desktopowych i w internecie. W kazdym srodowisku czyta repozytoria, modyfikuje pliki i wykonuje polecenia.
IronPPT to biblioteka .NET, która tworzy i edytuje pliki PowerPoint bez Office Interop. AddText dodaje tekst do slajdu, jak pokazuje przewodnik dodawania tekstu, a TextStyle ustawia jego wielkość, czcionkę i rozmiar. Cztery przetestowane prompty ustawiają Claude Code i umożliwiają mu zbudowanie generatora materiałów. Zachowania tekstowe IronPPT, od których zależy każdy prompt, są rejestrowane obok nich.
Otworzyć terminal w folderze projektu, uruchomić claude i wpisać /model opusplan przed pierwszym promptem. Ścieżka zaczynająca się od @ dołącza ten plik do żądania.
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.
Minimalny proces (5 kroków)
- Pobierz bibliotekę PowerPoint dla C# z NuGet
- Otworzyć Claude Code z folderu projektu i ustawić model za pomocą /model
- Zarejestruj zmierzone zasady tekstowe IronPPT w CLAUDE.md, aby każda sesja je wczytywała
- Zażądaj generatora, który ustawia każde pole tekstowe i pobiera każdy styl z pliku stylu domowego
- Sprawdź zapisany XML slajdu z plikiem stylu przed wydrukowaniem materiałów
Co robi Claude Code w projekcie prezentacji .NET?
Agent pisze generator, czyta pliki z zarysem, buduje jedną talię na każdy moduł i sprawdza każdą zapisaną talię z plikiem stylu. Gdy kontrola zawiedzie, czyta wygenerowany raport, poprawia generator i uruchamia go ponownie. Deweloper decyduje o stylu domu i tekście każdego slajdu.
Pierwszy prompt podaje nazwe pakietu IronPPT i jego wersje. Agent pozostawiony do wyboru nazwy pakietu moze zainstalowac pakiet, który zarejestrowal atakujacy pod nazwa wygenerowana przez narzedzia AI, ale nie uzywa jej zaden prawdziwy pakiet. To atak znany jako slopsquatting.
Jak skonfigurować Claude Code?
Zainstalować Claude Code i zalogować się, korzystając z szybkiego startu Anthropic. Konfiguracja jest zakończona, gdy claude uruchamia się w terminalu i odpowiada.
Jak skonfigurować projekt, w którym Claude Code może pracować?
Podaj agentowi rzeczywiste dane wejściowe przed pierwszym promptem. Fixture testowe to aplikacja konsolowa .NET 9 z folderem kursu, który zawiera dwa zarysy modułów i plik stylu domowego. Zarys modułu 3 obejmuje async i await w czterech tematach, a zarys modułu 4 obejmuje LINQ w trzech. Plik stylu definiuje siedem ról tekstowych, każda z czcionką, rozmiarem, wielkością, wyrównaniem i polem w punktach.
CLAUDE.md jest ładowany na początku każdej sesji, więc zasady tam zapisane stosują się do każdego późniejszego promptu. Drugi prompt tworzy plik i sprawdzającego o uprawnieniach tylko do odczytu dla kodu generatora.
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.
Claude Code wykrywa nowy plik subagenta bez restartu, pod warunkiem, że folder .claude/agents istniał, gdy sesja się rozpoczęła. Utworzyć ten folder w repozytorium przed uruchomieniem sesji. Dla poradników poza listą członków, IronPPT umieszcza swoją dokumentację dla agentów w llms.txt.
Które zasady tekstowe IronPPT należą do CLAUDE.md?
Każda linia pochodzi z testu wykonanego z i bez klucza licencyjnego, w którym każda zapisana talia została odczytana z powrotem z jej XML slajdu. Wklej blok w sekcji Prezentacje.
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.
IronPPT samodzielnie odczytuje zmienną środowiskową nazwaną IronPPT.LicenseKey, a sonda wykryła, że ignoruje IRONPPT_LICENSE_KEY.
Gdzie IronPPT umieszcza tekst na slajdzie?
Slide.AddText zapisuje tekst do nowego kształtu, który ma 150 na 100 punktów i nie ma żadnej pozycji. Zrzut ekranu przewodnika dodawania tekstu pokazuje wynik na pierwszym slajdzie, gdzie "Hello from IronPPT!" zawija się na trzy linie w wąskim polu w lewym górnym rogu. Każde kolejne AddText wywołane na tym samym slajdzie tworzy inny kształt o tej samej wielkości, bez żadnej pozycji, więc kształty się przekładają.
Materiały potrzebują każdego rodzaju tekstu w stałej pozycji. TextBox przyjmuje Position, Width i Height, wszystkie w punktach, i IronPPT zapisuje je na slajdzie jako przesunięcia i rozmiary. Sam slajd ma 720 na 540 punktów, standardowy rozmiar 4 na 3, więc plik stylu napisany dla szerokiej talii nie pasuje.
Slajd tytułowy materiałów modułu 3 z testowego uruchomienia pokazuje trzy pola tytułowe, każde ustawione i wymiarowane z pliku stylu.

Slajd 1 z materialów modułu 3, zapisany przez IronPPT w tescie probnym. Jest narysowany w skali na podstawie XML-a slajdu w rodzajach czcionek i rozmiarach, jakie nazwano. Kontury pól pochodza ze skryptu rysowania, a nie z renderowania PowerPointa.
Każde pole tekstowe zapisane przez IronPPT jest zarezerwowanym miejscem na treść. Styl treści szablonu slajdów, którym podąża zarezerwowane miejsca na treść, definiuje znak punktora i domyślny rozmiar 32 punkty.
Jakie style tekstowe zapisuje IronPPT do pliku?
IronPPT zapisuje pogrubienie, kursywę i rozmiar czcionki do pliku zgodnie z ustawieniami. Sonda ustawiła Font.FontFamily na Consolas i nie znalazła czcionki w właściwościach wykonania, podczas gdy Font.LatinFont zapisało czcionkę.
Wyrownanie zalezy od czlonka, który je ustawi. Paragraph.Alignment i Paragraph.SetAlignment oba zostawily wycentrowany akapit wyrowany w lewo. Ustawienie Paragraph.Style na ParagraphStyle z TextAlignmentTypeValues.Center zapisalo wycentrowane wyrownanie. Enum TextAlignmentTypeValues jest zadeklarowane w globalnym przestrzeni nazw, poza IronPPT.Enums.
Kazde kolorowe uruchomienie, nazwane lub szesnatsokowe, nie przeszlo walidacji Open XML SDK, poniewaz IronPPT zapisuje wartosci alfa i kanalu obok koloru zamiast w nim. Konstruktor Color(r, g, b) spowodowal, ze Save rzuca NullReferenceException. Underline zapisano wlasciwosci linii podkreslenia, ale nie atrybut, który wlacza podkreslenie. Wlasne skill.md IronPPT uzywa SetAlignment, kolorowego TextStyle i podkreslenia w swoich probkach, wiec agent, ktory kopiuje te probki, uzyska te same wyniki.
Jak wprowadzić kolejność IronPPT, która się kompiluje?
Poproś generator i jego sprawdzającego w jednym promcie i pozwól trybowi planu ukończyć projektowanie przed jakimikolwiek zmianami w plikach. Przejdź w tryb planu z Shift+Tab przed wysłaniem podpowiedzi. Z opusplan wybranym, Opus pisze plan, a Sonnet implementuje go po zatwierdzeniu planu.
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.
Dwie części promptu utrzymują poprawność materiałów.
- Plik stylu jako jedyne źródło: każda czcionka, rozmiar, waga, wyrównanie i pole pochodzi z jednego pliku, więc sprawdzacz może porównać każdy akapit z wartością zapisaną przez trenera.
- Sprawdzacz, który czyta XML: po przeładowaniu, IronPPT raportuje każdy rozmiar czcionki, pozycję i rozmiar pola jako 12 700 razy wartość w XML slajdu, a każde wyrównanie jako lewe. Kontrola oparta na czytniku IronPPT zawiodłaby poprawnie zapisane talie.
Czy kod wydruku w IronPPT można testować bez klucza licencyjnego?
Budowanie talii w pamięci i ładowanie zapisanej talii działają bez klucza. Tylko zapis wymaga klucza, więc projekt testowy może sprawdzać strukturę slajdów i weryfikatora na agencie budowlanym, który nie ma klucza.
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.
Co należy zweryfikować przed zaufaniem generowanemu kodowi IronPPT?
Zawiera następujące kontrole w przeglądzie.
- Kompilacja:
dotnet buildodrzuca czlonka, który nie istnieje. Dostarczony IronPPT.xml dokumentuje również członków, którzy się kompilują, ale tracą wartosc przy zapisywaniu, wiec pomyslna kompilacja potwierdza tylko istnienie nazw. - XML slajdu: porównaj czcionkę, rozmiar, wyrównanie i pole każdego akapitu z plikiem stylu.
- Jeden wydrukowany materiał: przed rozpoczęciem kursu wydrukuj jedną talię i potwierdź, że żaden tekst nie nakłada się na inny.
Aby uzyskać kompletny przykład zadania IronPPT z ustalonymi kryteriami zdawalności, które można ponownie uruchomić, należy zobaczyć przewodnik dla asystentów kodowania AI.
Co wyprodukowały zapytania w rzeczywistym uruchomieniu?
Claude Code wykonalo cztery prompty w jednej sesji, w kolejnosci. Blok zasad trafial do CLAUDE.md przed promtem 3. Kod nie byl edytowany recznie.
- Przed uruchomieniem repozytorium zawierało folder kursu i jednolinijkowy Program.cs, bez odniesienia do pakietu.
- Talie Quickstart miały 1 slajd z trzema polami tekstowymi, dwiema z nich puste miejsca na tytuł i podtytuł.
- CLAUDE.md otrzymało pięć zasad projektu, a plik subagenta wymienił tylko narzędzia Read, Grep i Glob.
- Po promcie 3 materiał modułu 3 miał 5 slajdów, a materiał modułu 4 miał 4.
- Wszystkie 26 pól tekstowych miały pozycję i rozmiar nadany przez plik stylu.
- W naszej kontroli XML slajdu wszystkie 38 akapitów odpowiadało plikowi stylu pod względem czcionki, rozmiaru, wagi i wyrównania.
- Raport sprawdzającego miał 38 wierszy, żaden wiersz nie był oznaczony jako nie.
- Własne podsumowanie promptu 3 Claude Code zawierało 37 wierszy, o jeden mniej niż miał raport.
- Linia kodu z czterema wiodącymi spacjami i zaakcentowanym nazwiskiem trenera pojawiła się na slajdach bez zmian.
- Oba materialy przeprowaly walidacje Open XML SDK z 0 bledami.
- Generator stworzył każde pole jako pozycjonowany TextBox i nigdy nie wywołał AddText.
- Subagent nie znalazl zadnego pola tekstowego bez pozycji i zaden ustawienie wymienione w zasadach jako utracone.
- 6 z 6 testów przeszło w procesie bez IRONPPT_LICENSE_KEY, i ponownie w nowym klonie.
- Uruchomienie Release w nowym klonie wydało te same dwie materiały i te same 38 wierszy.
- Bez klucza program pominął oba moduły i napisał raport z nagłówkiem i bez wierszy.
- Klucz licencyjny nie pojawił się w żadnym transkrypcie, pliku sesji ani pliku repozytorium z tej próby.
- Niektóre kroki uruchomiono inaczej niż na stronie. Sesja była uruchomiona bez głowy, więc plan pojawił się w odpowiedzi i odpowiedź wpisana zaakceptowała go. Strażnik uruchomienia, który utrzymywał agenta w repozytorium, zablokował plik planu, który Claude Code próbował zapisać w profilu użytkownika.
W materiałach modułu 3, slajd 3 zawierał drugi temat, z jego dwoma punktami i trzema liniami kodu.

Slajd 3 z materialów modulu 3, zapisany przez IronPPT w tescie probnym. Jest narysowany w skali na podstawie XML-a slajdu w rodzajach czcionek i rozmiarach, jakie nazwano. Kontury pól pochodza ze skryptu rysowania, a nie z renderowania PowerPointa.
Przewodnik po kursie również zawiera dla agenta napisanie planu najpierw, który Cursor zapisuje jako edytowalny plik Markdown. Przewodnik ChatGPT Codex zachowuje swoje zasady talii w AGENTS.md, które Codex czyta przed jakakolwiek praca, tak jak ten przewodnik robi z CLAUDE.md. Wersja Claude Code, modele, czasy i maszyna testowa dla tego uruchomienia sa w dzielonym rekordzie uruchomienia.
Rozwiązywanie problemów
- Zastosowanie kluczy licencyjnych, jeżeli
SaverzucaLicensingException - Zgłoszenie wsparcia technicznego aby zgłosić brakujący styl tekstu z zapisanego pliku
Pytania?
W przypadku jakichkolwiek pytań, należy skontaktować się z support@ironsoftware.com
Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.