Wie man IronPPT mit Claude Code verwendet
Ein Schulungsunternehmen gibt für jede Sitzung seines C#-Kurses ein PowerPoint-Handout heraus. Jedes Modul hat eine Gliederungsdatei mit den Themen, den Punkten unter jedem Thema, Codebeispielen und gelegentlichen Warnungen, und eine hausinterne Stildatei legt Schriftart, Größe und Position jeder Art von Text fest. Wenn die Decks von Hand zusammengestellt werden, kann eine falsche Schriftart oder ein sich überlappender Textkasten unbemerkt bleiben, bis ein Lernender das Handout druckt. Claude Code, der Software-Agent von Anthropic, läuft in Terminals, VS Code, JetBrains, Desktop-Anwendungen und im Web. In jeder Umgebung liest er Repositories, modifiziert Dateien und führt Befehle aus.
IronPPT ist eine .NET-Bibliothek, die PowerPoint-Dateien erstellt und bearbeitet, ohne Office Interop zu verwenden. AddText fügt einem Folien, wie im Leitfaden zum Hinzufügen von Text gezeigt, Text hinzu und TextStyle setzt sein Gewicht, die Schriftart und die Größe. Vier getestete Prompts richten Claude Code ein und lassen es den Handout-Generator erstellen. Die IronPPT-Textverhaltensweisen, von denen jeder Prompt abhängt, sind neben ihnen aufgezeichnet.
Öffnen Sie ein Terminal im Projektordner, führen Sie claude aus und geben Sie /model opusplan vor dem ersten Prompt ein. Ein Pfad, der mit @ beginnt, hängt diese Datei an die Anfrage an.
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.
Minimaler Arbeitsablauf (5 Schritte)
- Laden Sie die C# PowerPoint-Bibliothek von NuGet herunter
- Öffnen Sie Claude Code aus dem Projektverzeichnis und setzen Sie das Modell mit /model.
- Erfassen Sie die gemessenen Textregeln von IronPPT in CLAUDE.md, sodass jede Sitzung sie lädt.
- Fordern Sie einen Generator an, der jeden Textkasten positioniert und jeden Stil aus der hausinternen Stildatei übernimmt.
- Überprüfen Sie das gespeicherte Folien-XML gegen die Stildatei, bevor ein Handout gedruckt wird.
Was macht Claude Code in einem .NET-Präsentationsprojekt?
Der Agent schreibt den Generator, liest die Gliederungsdateien, erstellt ein Deck pro Modul und überprüft jedes gespeicherte Deck gegen die Stildatei. Wenn eine Überprüfung fehlschlägt, liest er den erstellten Bericht, korrigiert den Generator und führt ihn erneut aus. Der Entwickler entscheidet den Hausstil und den Text jeder Folie.
Der erste Prompt benennt das IronPPT-Paket und seine Version. Ein Agent, der zur Wahl eines Paketnamens verwendet wird, kann ein Paket installieren, das ein Angreifer unter einem Namen registriert hat, der von AI-Tools generiert wird, den jedoch kein echtes Paket verwendet. Dieser Angriff ist als Slopsquatting bekannt.
Wie richten Sie Claude Code ein?
Installieren Sie Claude Code und melden Sie sich an, indem Sie dem Schnellstart von Anthropic folgen. Die Einrichtung ist abgeschlossen, wenn claude in einem Terminal startet und reagiert.
Wie richten Sie ein Projekt ein, in dem Claude Code arbeiten kann?
Geben Sie dem Agenten echte Eingaben vor dem ersten Prompt. Das Test-Setup ist eine .NET 9-Konsolenanwendung mit einem Kursordner, der zwei Modulgliederungen und die hausinterne Stildatei enthält. Die Gliederung von Modul 3 behandelt asynchrone und await in vier Themen, und die Gliederung von Modul 4 behandelt LINQ in drei. Die Stildatei definiert sieben Textrollen, jeweils mit einer Schriftart, einer Größe, einem Gewicht, einer Ausrichtung und einer Box in Punkten.
CLAUDE.md wird zu Beginn jeder Sitzung geladen, sodass die dort geschriebenen Regeln für jeden späteren Prompt gelten. Der zweite Prompt erstellt die Datei und einen schreibgeschützten Prüfer für den Generatorcode.
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 erkennt eine neue Subagent-Datei ohne Neustart, vorausgesetzt, der Ordner .claude/agents existierte, als die Sitzung begann. Erstellen Sie diesen Ordner im Repository, bevor Sie die Sitzung starten. Für Anleitungen über die Mitgliederliste hinaus listet IronPPT seine Dokumentation für Agenten in llms.txt auf.
Welche IronPPT-Textregeln gehören in CLAUDE.md?
Jede Zeile stammt aus einem Testlauf mit und ohne Lizenzschlüssel, in dem jedes gespeicherte Deck aus seinem Folien-XML zurückgelesen wurde. Fügen Sie den Block unter der Präsentationssektion ein.
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 liest eine Umgebungsvariable namens IronPPT.LicenseKey von selbst, und die Untersuchung ergab, dass es IRONPPT_LICENSE_KEY ignoriert.
Wo platziert IronPPT Text auf einer Folie?
Slide.AddText schreibt den Text in eine neue Form, die 150 mal 100 Punkte groß ist und keine Position hat. Das eigene Screenshot des Leitfadens zum Hinzufügen von Text zeigt das Ergebnis auf der ersten Folie, wo "Hello from IronPPT!" in einer schmalen Box oben links über drei Zeilen umbricht. Jeder weitere AddText Aufruf auf derselben Folie schreibt eine weitere Form derselben Größe ohne Position, sodass sich die Formen überlappen.
Ein Handout benötigt jede Art von Text an einem festen Platz. Ein TextBox akzeptiert ein Position, ein Width und ein Height, alle in Punkten, und IronPPT schreibt sie als Offsets und Ausmaße auf die Folie. Die Folie selbst ist 720 mal 540 Punkte groß, die Standardgröße 4 zu 3, sodass eine für ein Breitbild-Deck geschriebene Stildatei nicht passt.
Die Titelfolie des Modul 3-Handouts aus dem Testrun zeigt die drei Titelboxen, jede platziert und dimensioniert aus der Stildatei.

Folie 1 des Modul 3-Handouts, wie es IronPPT im Testrun gespeichert hat. Es wird maßstabsgetreu aus dem Folien-XML gezeichnet, in den Schriftarten und Größen, die es benennt. Die Boxumrisse stammen aus dem Zeichnungsskript, das keine PowerPoint-Wiedergabe ist.
Jeder Textkasten, den IronPPT schreibt, ist ein Körperplatzhalter. Der Körperstil des Folienmasters, dem Körperplatzhalter folgen, definiert ein Aufzählungszeichen und eine 32-Punkte-Standardgröße.
Welche Textstile schreibt IronPPT in die Datei?
IronPPT schreibt Fett, Kursiv und die Schriftgröße wie eingestellt in die Datei. Der Testlauf legt Font.FontFamily auf Consolas fest und fand keine Schriftart in den Laufeigenschaften, während Font.LatinFont die Schriftart geschrieben hat.
Die Ausrichtung hängt davon ab, welches Mitglied sie festlegt. Paragraph.Alignment und Paragraph.SetAlignment ließen beide einen zentrierten Absatz links ausgerichtet. Das Setzen von Paragraph.Style auf ein ParagraphStyle mit TextAlignmentTypeValues.Center schrieb die zentrierte Ausrichtung. Das enum TextAlignmentTypeValues wird im globalen Namensraum deklariert, außerhalb IronPPT.Enums.
Jeder gefärbte Lauf, benannt oder hexadezimal, scheiterte am Open XML SDK-Validator, weil IronPPT die Alpha- und Kanalwerte neben der Farbe schreibt, anstatt sie in diese einzuschließen. Der Konstruktor Color(r, g, b) lässt Save NullReferenceException werfen. Ein Underline schrieb die Unterstrichlinien-Eigenschaften, aber nicht das Attribut, das das Unterstreichen aktiviert. Die eigene skill.md von IronPPT verwendet SetAlignment, ein gefärbtes TextStyle und ein Unterstrich in seinen Beispielen, daher erhält ein Agent, der diese Beispiele kopiert, die gleichen Ergebnisse.
Wie fordert man nach IronPPT-Code, der kompiliert, auf?
Fordern Sie den Generator und seinen Prüfer in einem Prompt an und erlauben Sie dem Planmodus, das Design vor Änderungen an Dateien zu vervollständigen. Wechseln Sie mit Shift+Tab in den Planmodus, bevor Sie den Prompt senden. Mit opusplan ausgewählt, schreibt Opus den Plan und Sonnet setzt ihn um, sobald der Plan genehmigt ist.
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.
Zwei Teile des Prompts halten die Handouts richtig.
- Die Stildatei als einzige Quelle: jede Schriftart, Größe, Gewicht, Ausrichtung und Box kommt aus einer Datei, daher kann der Prüfer jeden Absatz mit einem Wert vergleichen, den der Trainer notiert hat.
- Ein Prüfer, der das XML liest: Nach einem Neuladen meldet IronPPT jede Schriftgröße, Position und Boxgröße mit dem 12.700-fachen Wert des Folien-XMLs, und jede Ausrichtung als links. Ein Check auf Basis des IronPPT-Lesers würde korrekte Decks fehlschlagen.
Kann IronPPT-Handout-Code ohne Lizenzschlüssel getestet werden?
Ein Deck im Speicher zu erstellen und ein gespeichertes Deck zu laden, läuft ohne Schlüssel. Nur das Speichern benötigt einen, daher kann ein Testprojekt die Folienstruktur und den Prüfer auf einem Build-Agent prüfen, der keinen Schlüssel hat.
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.
Was sollten Sie überprüfen, bevor Sie generiertem IronPPT-Code vertrauen?
Schließen Sie die folgenden Prüfungen in die Überprüfung ein.
- Der Build:
dotnet buildlehnt ein Mitglied ab, das nicht existiert. Das gelieferte IronPPT.xml dokumentiert auch Mitglieder, die kompilieren und dennoch ihren Wert beim Speichern verlieren, daher beweist ein erfolgreicher Build nur, dass die Namen existieren. - Das Folien-XML: Vergleichen Sie die Schriftart, Größe, Ausrichtung und Box jedes Absatzes mit der Stildatei.
- Ein gedrucktes Handout: Vor Beginn eines Kurses drucken Sie ein Deck und bestätigen Sie, dass kein Textkasten einen anderen überlappt.
Für eine vollständige IronPPT-Aufgabe mit festen Bestehensregeln, die wiederholt ausgeführt werden kann, siehe den Leitfaden für KI-Codierungsassistenten.
Was haben die Aufforderungen in einem realen Lauf erzeugt?
Claude Code lief die vier Prompts in einer Sitzung in der Reihenfolge ab. Der Regelblock ging vor Prompt 3 in CLAUDE.md ein. Kein Code wurde von Hand bearbeitet.
- Vor dem Lauf hielt das Repository den Kursordner und einzeilige Program.cs ohne Paketreferenz.
- Das Schnellstart-Deck hatte 1 Folie mit drei Textkästen, zwei davon die leeren Titel- und Untertitelplatzhalter.
- CLAUDE.md erhielt die fünf Projektrichtlinien, und die Subagentendatei listete nur die Read, Grep und Glob-Tools auf.
- Nach Prompt 3 hatte das Modul 3-Handout 5 Folien und das Modul 4-Handout 4.
- Alle 26 Textkästen hatten die Position und Größe, die die Stildatei angibt.
- Bei unserer Überprüfung des Folien-XMLs stimmten alle 38 Absätze mit der Stildatei in Bezug auf Schriftart, Größe, Gewicht und Ausrichtung überein.
- Der Bericht des Prüfers enthielt 38 Zeilen, und keine Zeile war mit Nein markiert.
- Claude Codes eigene Zusammenfassung von Prompt 3 ergab 37 Zeilen, eine weniger als die Berichtsdatei.
- Die Codezeile mit vier führenden Leerzeichen und dem akzentuierten Trainernamen erschien unverändert auf den Folien.
- Beide Handzettel bestanden den Open XML SDK-Validator mit 0 Fehlern.
- Der Generator erstellte jede Box als positioniertes Textfeld und rief AddText nie auf.
- Der Subagent fand keine Textbox ohne Position und keine Einstellung, die auf der Regel-Liste als verloren aufgeführt war.
- 6 von 6 Tests bestanden in einem Prozess ohne IRONPPT_LIZENZSCHLÜSSEL, und nochmals in einem frischen Clone.
- Ein Release-Lauf in einem frischen Clone produzierte die gleichen zwei Handouts und die gleichen 38 Zeilen.
- Ohne Schlüssel übersprang das Programm beide Module und schrieb einen Bericht mit Header und keinen Zeilen.
- Der Lizenzschlüssel erschien in keinem Protokoll, Sitzungsdatei oder Repository-Datei dieses Laufs.
- Einige Schritte liefen anders als die Seite. Die Sitzung lief kopflos, daher erschien der Plan in der Antwort und eine getippte Antwort genehmigte ihn. Der Wächter des Laufs, der den Agenten im Repository hielt, blockierte die Plandatei, die Claude Code im Benutzerprofil zu speichern versuchte.
Im Handout von Modul 3 hielt Folie 3 das zweite Thema, mit seinen zwei Punkten und drei Codezeilen.

Folie 3 des Handouts von Modul 3, wie es IronPPT im Testrun gespeichert hat. Es wird maßstabsgetreu aus dem Folien-XML gezeichnet, in den Schriftarten und Größen, die es benennt. Die Boxumrisse stammen aus dem Zeichnungsskript, das keine PowerPoint-Wiedergabe ist.
Der Cursor-Leitfaden lässt den Agenten auch zuerst einen Plan schreiben, den Cursor als bearbeitbare Markdown-Datei speichert. Der ChatGPT Codex-Leitfaden hält seine Decksregeln in AGENTS.md, die Codex vor jeder Arbeit liest, genauso wie dieser Leitfaden dies mit CLAUDE.md tut. Die Claude Code-Version, Modelle, Zeitabläufe und Testmaschine für diesen Lauf befinden sich in der gemeinsamen Laufaufzeichnung.
Fehlerbehebung
- Lizenzschlüssel anwenden, wenn
SaveLicensingExceptionwirft - Technische Supportanfrage, um einen Textstil zu melden, der in der gespeicherten Datei fehlt
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.