Como usar IronPPT com Claude Code

Curtis Chau
Curtis Chau
Atualizado: 19 de outubro de 2026

Uma empresa de treinamento emite um material do PowerPoint para cada sessão de seu curso de C#. Cada módulo tem um arquivo de esboço com os tópicos, os pontos sob cada tópico, exemplos de código e avisos ocasionais, e um arquivo de estilo da casa fixa a fonte, tamanho e posição de cada tipo de texto. Quando os decks são montados à mão, uma fonte errada ou uma caixa de texto sobreposta pode passar despercebida até que um trainee imprima o material. Claude Code, o agente de software da Anthropic, roda em terminais, VS Code, JetBrains, aplicativos de desktop e na web. Em cada ambiente, ele lê repositórios, modifica arquivos e executa comandos.

IronPPT é uma biblioteca .NET que cria e edita arquivos PowerPoint sem Office Interop. AddText adiciona texto a um slide, conforme mostrado no guia de adição de texto, e TextStyle define seu peso, fonte e tamanho. Quatro sugestões testadas configuram o Claude Code e o fazem construir o gerador de material. Os comportamentos de texto do IronPPT dos quais cada sugestão depende estão registrados ao lado deles.

Início Rápido
NuGetInstalar com NuGet

PM > Install-Package IronPPT

Instale o IronPPT executando o comando acima no Console do Gerenciador de Pacotes NuGet, ou procure pelo pacote no Gerenciador de Pacotes NuGet.

Abra um terminal na pasta do projeto, execute claude e insira /model opusplan antes da primeira sugestão. Um caminho que começa com @ anexa esse arquivo à solicitação.

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


O que Claude Code faz em um projeto de apresentação .NET?

O agente escreve o gerador, lê os arquivos de esboço, constrói um deck por módulo e verifica cada deck salvo em relação ao arquivo de estilo. Quando uma verificação falha, ele lê o relatório que produziu, corrige o gerador e o executa novamente. O desenvolvedor decide o estilo da casa e o texto de cada slide.

A primeira sugestão nomeia o pacote IronPPT e sua versão. Um agente deixado para escolher um nome de pacote pode instalar um pacote que um atacante registrou sob um nome que ferramentas de IA geram, mas nenhum pacote real usa. Este ataque é conhecido como slopsquatting.

Como você configura o Claude Code?

Instale o Claude Code e faça login seguindo o início rápido da Anthropic. A configuração está completa quando claude inicia em um terminal e responde.

Como você configura um projeto no qual o Claude Code possa trabalhar?

Dê ao agente entradas reais antes da primeira sugestão. O fixture de teste é um aplicativo de console .NET 9 com uma pasta de curso que mantém dois esboços de módulos e o arquivo de estilo da casa. O esboço do módulo 3 cobre async e await em quatro tópicos, e o esboço do módulo 4 cobre LINQ em três. O arquivo de estilo define sete papéis de texto, cada um com uma fonte, um tamanho, um peso, um alinhamento e uma caixa em pontos.

CLAUDE.md é carregado no início de cada sessão, portanto, as regras escritas lá se aplicam a cada sugestão posterior. A segunda sugestão cria o arquivo e um revisor somente leitura para o código do gerador.

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 detecta um novo arquivo de subagente sem reiniciar, desde que a pasta .claude/agents existisse quando a sessão começou. Crie essa pasta no repositório antes de iniciar a sessão. Para guias além da lista de membros, IronPPT lista sua documentação para agentes em llms.txt.

Quais regras de texto do IronPPT pertencem ao CLAUDE.md?

Cada linha vem de uma execução de sonda com e sem uma chave de licença, na qual cada deck salvo foi lido de volta do XML do slide. Cole o bloco na seção Apresentações.

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 lê uma variável de ambiente chamada IronPPT.LicenseKey por si só, e a sonda descobriu que ignora IRONPPT_LICENSE_KEY.

Onde IronPPT coloca texto em um slide?

Slide.AddText escreve o texto em uma nova forma de 150 por 100 pontos sem posição. A própria captura de tela do guia de adição de texto mostra o resultado no primeiro slide, onde “Hello from IronPPT!” se ajusta em três linhas em uma caixa estreita no canto superior esquerdo. Cada chamada adicional AddText no mesmo slide escreve outra forma do mesmo tamanho sem posição, então as formas se sobrepõem.

Um material precisa de cada tipo de texto em um lugar fixo. Um TextBox aceita um Position, um Width e um Height, todos em pontos, e o IronPPT os escreve para o slide como offsets e extensões. O próprio slide tem 720 por 540 pontos, o tamanho padrão de 4 por 3, então um arquivo de estilo escrito para um deck widescreen não se ajusta.

O slide de título do material do módulo 3 da execução de teste mostra as três caixas de título, cada uma colocada e dimensionada a partir do arquivo de estilo.

Slide de título do material do módulo 3 desenhado à escala a partir do seu XML de slide

Slide 1 do material do módulo 3 conforme o IronPPT o salvou na execução de teste. Ele é desenhado à escala a partir do XML do slide nas fontes e tamanhos que nomeia. Os contornos das caixas vêm do script de desenho, que não é um renderização do PowerPoint.

Cada caixa de texto escrita pelo IronPPT é um placeholder de corpo. O estilo de corpo do mestre do slide, que os placeholders de corpo seguem, define um caractere de marcador e um tamanho padrão de 32 pontos.

Quais estilos de texto o IronPPT escreve para o arquivo?

IronPPT escreve em negrito, itálico e o tamanho da fonte para o arquivo conforme definido. A sonda definiu Font.FontFamily para Consolas e não encontrou fonte nas propriedades de execução, enquanto Font.LatinFont escreveu a fonte.

O alinhamento depende de qual membro o define. Paragraph.Alignment e Paragraph.SetAlignment deixaram um parágrafo centralizado alinhado à esquerda. Definindo Paragraph.Style para um ParagraphStyle com TextAlignmentTypeValues.Center escreveu o alinhamento centralizado. O enum TextAlignmentTypeValues é declarado no namespace global, fora de IronPPT.Enums.

Cada execução colorida, nomeada ou hexadecimal, falhou no validador do Open XML SDK, porque IronPPT escreve os valores alpha e de canal ao lado da cor em vez de dentro dela. O construtor Color(r, g, b) fez Save lançar NullReferenceException. Um Underline escreveu as propriedades da linha sublinhada, mas não o atributo que ativa o sublinhado. O próprio skill.md do IronPPT usa SetAlignment, um TextStyle colorido e um sublinhado em seus exemplos, então um agente que copia esses exemplos obtém os mesmos resultados.

Como solicitar código IronPPT que compile?

Solicite o gerador e seu verificador em uma única sugestão e permita que o modo plano complete o design antes de qualquer alteração de arquivo. Mude para o modo plano com Shift+Tab antes de enviar a sugestão. Com opusplan selecionado, o Opus escreve o plano e o Sonnet o implementa uma vez que o plano é aprovado.

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

Duas partes da sugestão mantêm os materiais corretos.

  1. O arquivo de estilo como a fonte única: cada fonte, tamanho, peso, alinhamento e caixa vem de um arquivo, então o verificador pode comparar cada parágrafo com um valor que o treinador escreveu.
  2. Um verificador que lê o XML: após um recarregamento, o IronPPT relata cada tamanho de fonte, posição e tamanho de caixa em 12.700 vezes o valor no XML do slide, e cada alinhamento como à esquerda. Uma verificação baseada no leitor do IronPPT falharia decks corretos.
Dicas: Aprove o plano apenas se cada caixa for uma TextBox posicionada e cada fonte for definida através de LatinFont.

O código de material do IronPPT pode ser testado sem uma chave de licença?

Construir um deck na memória e carregar um deck salvo ambos rodam sem uma chave. Apenas o salvamento precisa de uma, então um projeto de teste pode verificar a estrutura do slide e o verificador em um agente de construção que não tenha chave.

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

O que você deve verificar antes de confiar no código gerado do IronPPT?

Inclua as seguintes verificações na revisão.

  • A compilação: dotnet build rejeita um membro que não existe. O IronPPT.xml enviado também documenta membros que compilam e ainda perdem seu valor ao salvar, então uma compilação bem-sucedida prova apenas que os nomes existem.
  • O XML do slide: compare a fonte, tamanho, alinhamento e caixa de cada parágrafo com o arquivo de estilo.
  • Um material impresso: antes de um curso começar, imprima um deck e confirme que nenhuma caixa de texto se sobrepõe a outra.

Para uma tarefa completa do IronPPT com critérios de aprovação fixos que pode ser executada novamente, veja o guia de assistentes de codificação IA.

O que os prompts produziram em uma execução real?

Claude Code executou as quatro sugestões em uma sessão, em ordem. O bloco de regras foi para o CLAUDE.md antes da sugestão 3. Nenhum código foi editado à mão.

  • Antes da execução, o repositório continha a pasta do curso e um Program.cs de uma linha, sem referência a pacotes.
  • O deck de Início Rápido tinha 1 slide com três caixas de texto, duas delas os espaços reservados de título e subtítulo vazios.
  • CLAUDE.md recebeu as cinco regras do projeto, e o arquivo de subagente listava apenas as ferramentas Read, Grep e Glob.
  • Após a sugestão 3, o material do módulo 3 tinha 5 slides e o material do módulo 4 tinha 4.
  • Todas as 26 caixas de texto tinham a posição e o tamanho que o arquivo de estilo fornece.
  • Em nossa verificação do XML do slide, todos os 38 parágrafos correspondiam ao arquivo de estilo em fonte, tamanho, peso e alinhamento.
  • O relatório do verificador tinha 38 linhas, e nenhuma linha estava marcada como não.
  • O próprio resumo da sugestão 3 do Claude Code deu 37 linhas, uma a menos do que o relatório continha.
  • A linha de código com quatro espaços à frente e o nome do treinador acentuado apareceu nos slides sem alterações.
  • Ambos os materiais passaram pelo validador do Open XML SDK com 0 erros.
  • O gerador criou cada caixa como uma TextBox posicionada e nunca chamou AddText.
  • O subagente não encontrou caixa de texto sem posição e nenhuma configuração que a lista de regras menciona como perdida.
  • 6 de 6 testes passaram em um processo sem IRONPPT_LICENSE_KEY, e novamente em um clone novo.
  • Uma execução Release em um clone novo produziu os mesmos dois materiais e as mesmas 38 linhas.
  • Sem uma chave, o programa ignorou ambos os módulos e escreveu um relatório com um cabeçalho e sem linhas.
  • A chave de licença não apareceu em nenhuma transcrição, arquivo de sessão ou arquivo de repositório desta execução.
  • Alguns passos foram executados de forma diferente da página. A sessão foi executada sem interface gráfica, então o plano apareceu na resposta e uma resposta digitada o aprovou. O guardião da execução, que mantinha o agente dentro do repositório, bloqueou o arquivo de plano que o Claude Code tentou salvar no perfil do usuário.

No material do módulo 3, o slide 3 continha o segundo tópico, com seus dois pontos e três linhas de código.

Slide 3 do material do módulo 3 desenhado à escala a partir do seu XML de slide

Slide 3 do material do módulo 3 conforme o IronPPT o salvou na execução de teste. Ele é desenhado à escala a partir do XML do slide nas fontes e tamanhos que nomeia. Os contornos das caixas vêm do script de desenho, que não é uma renderização do PowerPoint.

O guia Cursor também faz o agente escrever um plano primeiro, que o Cursor salva como um arquivo Markdown editável. O guia ChatGPT Codex mantém suas regras de deck em AGENTS.md, que o Codex lê antes de qualquer trabalho, como este guia faz com CLAUDE.md. A versão do Claude Code, modelos, tempos e máquina de teste para essa execução estão no registro da execução compartilhado.


Solução de problemas


Questões?

Se você tiver dúvidas, entre em contato com support@ironsoftware.com

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.

Leia Mais

Pronto para começar?

Downloads no NuGet 7,110Versão:2026.11recém-lançado