Comment utiliser IronPPT avec Claude Code

Curtis Chau
Curtis Chau
Mis à jour : 19 octobre 2026

Une société de formation distribue un document PowerPoint pour chaque session de son cours C#. Chaque module possède un fichier de plan avec les sujets, les points sous chaque sujet, des exemples de code et parfois un avertissement, et un fichier de style fixe la police, la taille et la position de chaque type de texte. Lorsque les présentations sont assemblées manuellement, une police incorrecte ou une zone de texte qui chevauche peut passer inaperçue jusqu'à ce qu'un stagiaire imprime le document. Claude Code, l'agent logiciel d'Anthropic, fonctionne dans les terminaux, VS Code, JetBrains, les applications de bureau et sur le web. Dans chaque environnement, il lit les dépôts, modifie les fichiers et exécute les commandes.

IronPPT est une bibliothèque .NET qui crée et modifie des fichiers PowerPoint sans Office Interop. AddText ajoute du texte à une diapositive, comme le montre le guide d'ajout de texte, et TextStyle définit son poids, sa police et sa taille. Quatre invites testées configurent Claude Code et le font construire le générateur de documents. Les comportements de texte d'IronPPT dont dépend chaque invite sont enregistrés à côté d'eux.

Démarrage rapide
NuGetInstaller avec NuGet

PM > Install-Package IronPPT

Installez IronPPT en exécutant la commande ci-dessus dans la console du gestionnaire de packages NuGet, ou recherchez le package dans le gestionnaire de packages NuGet.

Ouvrez un terminal dans le dossier du projet, exécutez claude, et entrez /model opusplan avant la première invite. Un chemin qui commence par @ joint ce fichier à la requête.

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


Que fait Claude Code dans un projet de présentation .NET ?

L'agent écrit le générateur, lit les fichiers de plan, assemble une présentation par module et vérifie chaque présentation enregistrée par rapport au fichier de style. Lorsqu'une vérification échoue, il lit le rapport qu'il a produit, corrige le générateur et le réexécute. Le développeur décide du style maison et du texte de chaque diapositive.

La première invite nomme le package IronPPT et sa version. Un agent laissé pour choisir un nom de package peut installer un package qu'un attaquant a enregistré sous un nom généré par des outils d'IA mais qu'aucun package réel n'utilise. Cette attaque est connue sous le nom de slopsquatting.

Comment configurer Claude Code ?

Installez Claude Code et connectez-vous en suivant le quickstart d'Anthropic. La configuration est terminée lorsque claude démarre dans un terminal et répond.

Comment configurer un projet dans lequel Claude Code peut travailler ?

Donnez à l'agent de vraies entrées avant la première invite. Le dispositif de test est une application console .NET 9 avec un dossier de cours qui contient deux plans de module et le fichier de style maison. Le plan du module 3 couvre async et await en quatre sujets, et le plan du module 4 couvre LINQ en trois. Le fichier de style définit sept rôles de texte, chacun avec une police, une taille, un poids, un alignement et une boîte en points.

CLAUDE.md est chargé au début de chaque session, donc les règles écrites là-bas s'appliquent à chaque invite ultérieure. La deuxième invite crée le fichier et un relecteur en lecture seule pour le code du générateur.

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 détecte un nouveau fichier de sous-agent sans redémarrage, à condition que le dossier .claude/agents existait au démarrage de la session. Créez ce dossier dans le dépôt avant de lancer la session. Pour des guides au-delà de la liste des membres, IronPPT liste sa documentation pour les agents dans llms.txt.

Quels règles de texte IronPPT appartiennent à CLAUDE.md ?

Chaque ligne provient d'un test effectué avec et sans clé de licence, dans lequel chaque présentation enregistrée a été relue depuis son XML de diapositive. Collez le bloc sous la section Présentations.

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 lit par lui-même une variable d'environnement nommée IronPPT.LicenseKey, et le test a constaté qu'il ignore IRONPPT_LICENSE_KEY.

Où IronPPT place-t-il le texte sur une diapositive ?

Slide.AddText écrit le texte dans une nouvelle forme de 150 par 100 points et sans position. La capture d'écran du guide d'ajout de texte montre le résultat sur la première diapositive, où "Bonjour de IronPPT !" s'enroule sur trois lignes dans une boîte étroite en haut à gauche. Chaque nouvel appel AddText sur la même diapositive écrit une autre forme de la même taille sans position, de sorte que les formes se chevauchent.

Un document a besoin de chaque type de texte à une place fixe. Un TextBox accepte un Position, un Width et un Height, tous en points, et IronPPT les écrit sur la diapositive en tant que décalages et étendues. La diapositive elle-même mesure 720 par 540 points, la taille standard de 4 par 3, donc un fichier de style écrit pour une présentation grand écran ne convient pas.

La diapositive titre du document du module 3 de l'exécution de test montre les trois boîtes de titre, chacune placée et dimensionnée depuis le fichier de style.

Diapositive titre du document du module 3 dessinée à l'échelle à partir de son XML de diapositive

Diapositive 1 du document du module 3 telle qu'IronPPT l'a enregistrée dans l'exécution de test. Elle est dessinée à l'échelle à partir du XML de diapositive dans les polices et tailles qu'elle nomme. Les contours des boîtes viennent du script de dessin, qui n'est pas un rendu PowerPoint.

Chaque zone de texte écrite par IronPPT est un espace réservé de corps. Le style de corps de la diapositive maître, que les espaces réservés de corps suivent, définit un caractère de puce et une taille par défaut de 32 points.

Quels styles de texte IronPPT écrit-il dans le fichier ?

IronPPT écrit le gras, l'italique et la taille de la police dans le fichier tel qu'établi. Le test a défini Font.FontFamily sur Consolas et n'a trouvé aucune police dans les propriétés d'exécution, tandis que Font.LatinFont a écrit la police.

L'alignement dépend de quel membre le définit. Paragraph.Alignment et Paragraph.SetAlignment ont tous deux laissé un paragraphe centré aligné à gauche. Définir Paragraph.Style sur un ParagraphStyle avec TextAlignmentTypeValues.Center a écrit l'alignement centré. L'énumération TextAlignmentTypeValues est déclarée dans l'espace de noms global, en dehors de IronPPT.Enums.

Chaque exécution colorée, nommée ou hexadécimale, a échoué au validateur Open XML SDK, car IronPPT écrit les valeurs alpha et de canal à côté de la couleur au lieu de l'intérieur. Le constructeur Color(r, g, b) a fait lancer Save NullReferenceException. Un Underline a écrit les propriétés de ligne de soulignement mais pas l'attribut qui active le soulignement. Le propre skill.md d'IronPPT utilise SetAlignment, un TextStyle coloré et un sous-lignage dans ses exemples, donc un agent qui copie ces exemples obtient les mêmes résultats.

Comment demander un code IronPPT qui se compile ?

Demandez le générateur et son vérificateur en une seule invite, et permettez au mode plan de compléter la conception avant tout changement de fichier. Passez en mode plan avec Shift+Tab avant d'envoyer l'invite. Avec opusplan sélectionné, Opus écrit le plan et Sonnet le met en œuvre une fois que le plan est approuvé.

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

Deux parties de l'invite maintiennent les documents corrects.

  1. Le fichier de style comme source unique : chaque police, taille, poids, alignement et boîte provient d'un fichier, de sorte que le vérificateur peut comparer chaque paragraphe à une valeur que le formateur a écrite.
  2. Un vérificateur qui lit le XML : après un rechargement, IronPPT rapporte chaque taille de police, position et taille de boîte 12 700 fois la valeur dans le XML de la diapositive, et chaque alignement comme gauche. Un contrôle basé sur le lecteur IronPPT échouerait aux présentations correctes.
Conseils: Approuvez le plan uniquement si chaque boîte est une TextBox positionnée et chaque police est définie via LatinFont.

Le code de document IronPPT peut-il être testé sans clé de licence ?

Construire une présentation en mémoire et charger une présentation enregistrée fonctionnent tous deux sans clé. Seule la sauvegarde en nécessite une, donc un projet de test peut vérifier la structure des diapositives et le vérificateur sur un agent de construction sans clé.

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

Que devez-vous vérifier avant de faire confiance au code IronPPT généré ?

Incluez les contrôles suivants dans la révision.

  • La construction : dotnet build rejette un membre qui n'existe pas. IronPPT.xml documente également les membres qui se compilent et perdent tout de même leur valeur lors de la sauvegarde, donc une construction réussie prouve seulement que les noms existent.
  • Le XML de la diapositive : comparez la police, la taille, l'alignement et la boîte de chaque paragraphe avec le fichier de style.
  • Un document imprimé : avant qu'un cours ne commence, imprimez une présentation et confirmez qu'aucune zone de texte ne chevauche une autre.

Pour une tâche IronPPT complète avec des critères de passage fixes qui peut être exécutée à nouveau, consultez le guide des assistants de codage IA.

Qu'est-ce que les messages ont produit lors d'une réelle exécution ?

Claude Code a exécuté les quatre invites en une seule session, dans l'ordre. Le bloc des règles est allé dans CLAUDE.md avant l'invite 3. Aucun code n'a été édité manuellement.

  • Avant l'exécution, le dépôt contenait le dossier de cours et un Program.cs d'une ligne, sans référence de package.
  • La présentation rapide avait 1 diapositive avec trois zones de texte, dont deux espaces réservés de titre et de sous-titre vides.
  • CLAUDE.md a reçu les cinq règles du projet, et le fichier de sous-agent listait uniquement les outils Read, Grep et Glob.
  • Après l'invite 3, le document du module 3 avait 5 diapositives et le document du module 4 en avait 4.
  • Toutes les 26 zones de texte avaient la position et la taille que le fichier de style donne.
  • Dans notre vérification du XML de la diapositive, tous les 38 paragraphes correspondaient au fichier de style en termes de police, taille, poids et alignement.
  • Le rapport du vérificateur contenait 38 lignes, et aucune ligne n'était marquée non.
  • Le résumé de Claude Code de l'invite 3 donnait 37 lignes, une de moins que le fichier de rapport.
  • La ligne de code avec quatre espaces en début et le nom du formateur accentué apparurent sur les diapositives inchangés.
  • Les deux documents sont passés au validateur Open XML SDK avec 0 erreurs.
  • Le générateur a créé chaque boîte comme une TextBox positionnée et n'a jamais appelé AddText.
  • Le sous-agent n'a trouvé aucune zone de texte sans position et aucun paramètre que la liste de règles mentionne comme perdu.
  • 6 des 6 tests réussis dans un processus sans IRONPPT_LICENSE_KEY, et à nouveau dans un clone frais.
  • Une exécution Release dans un clone frais a produit les mêmes deux documents et les mêmes 38 lignes.
  • Sans clé, le programme a sauté les deux modules et a rédigé un rapport avec un en-tête et aucune ligne.
  • La clé de licence n'est apparue dans aucun transcript, fichier de session, ou fichier de dépôt de cette exécution.
  • Certaines étapes ont été exécutées différemment de la page. La session s'est déroulée sans interface, donc le plan est apparu dans la réponse et une réponse tapée l'a approuvé. Le garde de l'exécution, qui gardait l'agent à l'intérieur du dépôt, a bloqué le fichier de plan que Claude Code a essayé de sauvegarder dans le profil utilisateur.

Dans le document du module 3, la diapositive 3 contenait le deuxième sujet, avec ses deux points et trois lignes de code.

Diapositive 3 du document du module 3 dessinée à l'échelle à partir de son XML de diapositive

Diapositive 3 du document du module 3 telle qu'IronPPT l'a enregistrée dans l'exécution de test. Elle est dessinée à l'échelle à partir du XML de la diapositive dans les polices et tailles qu'elle nomme. Les contours des boîtes viennent du script de dessin, qui n'est pas un rendu PowerPoint.

Le guide de Cursor demande également à l'agent d'écrire d'abord un plan, que Cursor enregistre comme fichier Markdown modifiable. Le guide de ChatGPT Codex conserve ses règles de présentation dans AGENTS.md, que Codex lit avant tout travail, comme ce guide le fait avec CLAUDE.md. La version de Claude Code, les modèles, les temps et la machine de test pour cette exécution sont dans le journal partagé.


Dépannage


Des questions ?

Si vous avez des questions, contactez support@ironsoftware.com

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.

Lire la suite

Prêt à commencer ?

Téléchargements NuGet 7,110Version :2026.11tout juste publié