Cómo usar IronPPT con Claude Code
Una empresa de formación emite un folleto de PowerPoint para cada sesión de su curso de C#. Cada módulo tiene un archivo de esquema con los temas, los puntos bajo cada tema, ejemplos de código y advertencias ocasionales, y un archivo de estilo de casa fija la tipografía, tamaño y posición de cada tipo de texto. Cuando las presentaciones se ensamblan a mano, una fuente incorrecta o un cuadro de texto superpuesto pueden pasar desapercibidos hasta que un alumno imprime el folleto. Claude Code, el agente software de Anthropic, se ejecuta en terminales, VS Code, JetBrains, aplicaciones de escritorio y en la web. En cada entorno, lee repositorios, modifica archivos y ejecuta comandos.
IronPPT es una biblioteca .NET que crea y edita archivos de PowerPoint sin Office Interop. AddText agrega texto a una diapositiva, como lo muestra la guía de agregar texto, y TextStyle establece su peso, fuente y tamaño. Cuatro mensajes probados configuran Claude Code y hacen que construya el generador de folletos. Los comportamientos de texto de IronPPT de los que dependen cada mensaje están registrados junto a ellos.
Abra una terminal en la carpeta del proyecto, ejecute claude, e ingrese /model opusplan antes del primer mensaje. Un camino que comienza con @ adjunta ese archivo a la solicitud.
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.
Flujo de trabajo mínimo (5 pasos)
- Descarga la biblioteca de PowerPoint de C# desde NuGet
- Abra Claude Code desde la carpeta del proyecto y configure el modelo con /model
- Registre las reglas de texto medidas de IronPPT en CLAUDE.md para que cada sesión las cargue
- Solicite un generador que posicione cada cuadro de texto y tome cada estilo del archivo de estilo de casa
- Verifique el XML de la diapositiva guardada contra el archivo de estilo antes de que un folleto se imprima
¿Qué hace Claude Code en un proyecto de presentación .NET?
El agente escribe el generador, lee los archivos de esquema, construye un mazo por módulo y verifica cada mazo guardado contra el archivo de estilo. Cuando una verificación falla, lee el informe que produjo, corrige el generador y lo ejecuta de nuevo. El desarrollador decide el estilo de la casa y el texto de cada diapositiva.
El primer mensaje nombra el paquete de IronPPT y su versión. Un agente dejado para elegir un nombre de paquete puede instalar un paquete que un atacante registró bajo un nombre que las herramientas de AI generan pero que ningún paquete real usa. Este ataque se conoce como slopsquatting.
¿Cómo configuras Claude Code?
Instale Claude Code e inicie sesión siguiendo el inicio rápido de Anthropic. La configuración está completa cuando claude comienza en un terminal y responde.
¿Cómo configuras un proyecto en el que Claude Code pueda trabajar?
Dé al agente entradas reales antes del primer mensaje. El fixture de prueba es una aplicación de consola .NET 9 con una carpeta de curso que contiene dos esquemas de módulos y el archivo de estilo de casa. El esquema del módulo 3 abarca async y await en cuatro temas, y el esquema del módulo 4 abarca LINQ en tres. El archivo de estilo define siete roles de texto, cada uno con una tipografía, un tamaño, un peso, una alineación y un cuadro en puntos.
CLAUDE.md se carga al inicio de cada sesión, por lo que las reglas escritas allí se aplican a cada mensaje posterior. El segundo mensaje crea el archivo y un revisor de solo lectura para el código del generador.
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 detecta un nuevo archivo de subagente sin reinicar, siempre que la carpeta .claude/agents existiera cuando la sesión comenzó. Cree esa carpeta en el repositorio antes de lanzar la sesión. Para guías más allá de la lista de miembros, IronPPT lista su documentación para agentes en llms.txt.
¿Qué reglas de texto de IronPPT pertenecen a CLAUDE.md?
Cada línea proviene de una ejecución de sonda con y sin una clave de licencia, en la cual cada mazo guardado se leyó de nuevo desde su XML de diapositiva. Pegue el bloque bajo la sección Presentaciones.
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 lee una variable de entorno llamada IronPPT.LicenseKey por sí solo, y la sonda encontró que ignora IRONPPT_LICENSE_KEY.
¿Dónde coloca IronPPT el texto en una diapositiva?
Slide.AddText escribe el texto en una nueva forma que es de 150 por 100 puntos y no tiene posición. La captura de pantalla de la propia guía de agregar texto muestra el resultado en la primera diapositiva, donde "¡Hola desde IronPPT!" se envuelve en tres líneas en un cuadro estrecho en la parte superior izquierda. Cada llamada adicional de AddText en la misma diapositiva escribe otra forma del mismo tamaño sin posición, por lo que las formas se superponen.
Un folleto necesita cada tipo de texto en un lugar fijo. TextBox acepta un Position, un Width y un Height, todos en puntos, e IronPPT los escribe en la diapositiva como desplazamientos y extensiones. La propia diapositiva es de 720 por 540 puntos, el tamaño estándar de 4 por 3, por lo que un archivo de estilo escrito para un mazo panorámico no encaja.
La diapositiva de título del folleto del módulo 3 de la prueba muestra los tres cuadros de título, cada uno colocado y dimensionado del archivo de estilo.

Diapositiva 1 del folleto del módulo 3 tal como IronPPT la guardó en la prueba. Está dibujada a escala desde el XML de la diapositiva en las tipografías y tamaños que nombra. Los contornos de los cuadros provienen del script de dibujo, que no es un renderizado de PowerPoint.
Cada cuadro de texto que IronPPT escribe es un marcador de posición de cuerpo. El estilo de cuerpo del maestro de diapositivas, que siguen los marcadores de posición de cuerpo, define un carácter de viñeta y un tamaño por defecto de 32 puntos.
¿Qué estilos de texto escribe IronPPT en el archivo?
IronPPT escribe negrita, cursiva y el tamaño de fuente en el archivo tal como se establece. La sonda estableció Font.FontFamily a Consolas y no encontró tipografía en las propiedades de ejecución, mientras que Font.LatinFont escribió la tipografía.
La alineación depende de cuál miembro la establece. Paragraph.Alignment y Paragraph.SetAlignment dejaron ambos un párrafo centrado alineado a la izquierda. Al establecer Paragraph.Style a un ParagraphStyle con TextAlignmentTypeValues.Center se escribió la alineación centrada. El enum TextAlignmentTypeValues se declara en el espacio de nombres global, fuera de IronPPT.Enums.
Cada ejecución coloreada, nombrada o hexadecimal, falló el validador del Open XML SDK, porque IronPPT escribe los valores alfa y de canal junto al color en lugar de dentro de él. El constructor Color(r, g, b) hizo que Save lanzara NullReferenceException. Un Underline escribió las propiedades de línea subrayada pero no el atributo que activa el subrayado. El propio skill.md de IronPPT usa SetAlignment, un TextStyle coloreado y un subrayado en sus muestras, por lo que un agente que copie esas muestras obtiene los mismos resultados.
¿Cómo pedir código de IronPPT que compile?
Solicite el generador y su verificador en un solo mensaje, y permita que el modo plan complete el diseño antes de cualquier cambio de archivo. Cambie al modo plan con Shift+Tab antes de enviar el mensaje. Con opusplan seleccionado, Opus escribe el plan y Sonnet lo implementa una vez que el plan es aprobado.
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.
Dos partes del mensaje mantienen los folletos correctos.
- El archivo de estilo como la única fuente: cada tipo de letra, tamaño, peso, alineación y caja proviene de un archivo, por lo que el verificador puede comparar cada párrafo con un valor que el instructor anotó.
- Un verificador que lea el XML: después de una recarga, IronPPT informa cada tamaño de fuente, posición y tamaño de caja a 12,700 veces el valor en el XML de la diapositiva, y cada alineación como izquierda. Una verificación basada en el lector de IronPPT fallaría mazos correctos.
¿Se puede probar el código de folletos de IronPPT sin una clave de licencia?
Construir un mazo en memoria y cargar un mazo guardado se ejecuta sin una clave. Solo el guardado necesita una, por lo que un proyecto de prueba puede verificar la estructura de la diapositiva y el verificador en un agente de compilación que no tiene clave.
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.
¿Qué debe verificar antes de confiar en el código generado de IronPPT?
Incluya las siguientes verificaciones en la revisión.
- La construcción:
dotnet buildrechaza un miembro que no existe. El IronPPT.xml enviado también documenta miembros que compilan y aún pierden su valor al guardar, por lo que una construcción exitosa solo prueba que los nombres existen. - El XML de la diapositiva: compare la tipografía, tamaño, alineación y caja de cada párrafo con el archivo de estilo.
- Un folleto impreso: antes de que comience un curso, imprima un mazo y confirme que ningún cuadro de texto se superponga a otro.
Para una tarea completa de IronPPT con criterios de aprobación establecidos que se puede volver a ejecutar, consulte el guía de asistentes de codificación AI.
¿Qué produjeron los prompts en una ejecución real?
Claude Code ejecutó los cuatro mensajes en una sesión, en orden. El bloque de reglas se incluyó en CLAUDE.md antes del mensaje 3. No se editó el código manualmente.
- Antes de la ejecución, el repositorio contenía la carpeta del curso y un Program.cs de una línea, sin referencia a paquetes.
- El mazo de inicio rápido tenía 1 diapositiva con tres cuadros de texto, dos de ellos los marcadores de posición de título y subtítulo vacíos.
- CLAUDE.md recibió las cinco reglas del proyecto, y el archivo de subagente solo enumeró las herramientas Read, Grep y Glob.
- Después del mensaje 3, el folleto del módulo 3 tenía 5 diapositivas y el folleto del módulo 4 tenía 4.
- Todos los 26 cuadros de texto tenían la posición y tamaño que da el archivo de estilo.
- En nuestra revisión del XML de la diapositiva, todos los 38 párrafos coincidieron con el archivo de estilo en tipografía, tamaño, peso y alineación.
- El informe del verificador contenía 38 filas, y ninguna fila estaba marcada como no.
- El resumen propio del mensaje 3 de Claude Code dio 37 filas, una menos que el archivo del informe contenía.
- La línea de código con cuatro espacios iniciales y el nombre del instructor con acento apareció en las diapositivas sin cambios.
- Ambos folletos pasaron el validador del Open XML SDK con 0 errores.
- El generador creó cada cuadro como un TextBox posicionado y nunca llamó a AddText.
- El subagente no encontró cuadro de texto sin posición ni configuración que la lista de reglas indique como perdida.
- 6 de 6 pruebas pasaron en un proceso sin IRONPPT_LICENSE_KEY, y nuevamente en un clon nuevo.
- Una ejecución Release en un clon nuevo produjo los mismos dos folletos y las mismas 38 filas.
- Sin una clave, el programa omitió ambos módulos y escribió un informe con un encabezado y sin filas.
- La clave de licencia no apareció en ninguna transcripción, archivo de sesión o archivo de repositorio de esta ejecución.
- Algunos pasos se ejecutaron de manera diferente a lo esperado. La sesión se ejecutó sin interfaz, por lo que el plan apareció en la respuesta y una respuesta escrita lo aprobó. El guardián de la ejecución, que mantuvo al agente dentro del repositorio, bloqueó el archivo de plan que Claude Code intentó guardar en el perfil del usuario.
En el folleto del módulo 3, la diapositiva 3 contenía el segundo tema, con sus dos puntos y tres líneas de código.

Diapositiva 3 del folleto del módulo 3 tal como IronPPT la guardó en la prueba. Está dibujada a escala desde el XML de la diapositiva en las tipografías y tamaños que nombra. Los contornos de los cuadros provienen del script de dibujo, que no es un renderizado de PowerPoint.
La guía de Cursor también hace que el agente escriba primero un plan, el cual Cursor guarda como un archivo Markdown editable. La guía de ChatGPT Codex mantiene sus reglas de mazo en AGENTS.md, que Codex lee antes de cualquier trabajo, como lo hace esta guía con CLAUDE.md. La versión de Claude Code, los modelos, los tiempos y la máquina de prueba para esta ejecución están en el registro de ejecución compartido.
Solución de problemas
- Aplicación de claves de licencia si
SavelanzaLicensingException - Solicitud de soporte de ingeniería para informar sobre un estilo de texto que falta en el archivo guardado
¿Preguntas?
Si tienes alguna pregunta, contacta a support@ironsoftware.com
Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.