Claude Code와 함께 IronPPT 사용 방법
한 교육 회사는 각 C# 강의 세션마다 PowerPoint 유인물을 발행합니다. 각 모듈에는 주제, 각 주제에 따른 포인트, 코드 샘플 및 간헐적인 경고가 포함된 개요 파일과, 유형, 크기 및 모든 종류의 텍스트의 위치를 고정하는 집 스타일 파일이 있습니다. 덱이 수작업으로 조립될 때, 잘못된 폰트나 겹치는 텍스트 상자는 교육생이 유인물을 인쇄하기 전까지 감지되지 않을 수 있습니다. Anthropic의 소프트웨어 에이전트인 Claude Code는 터미널, VS Code, JetBrains, 데스크탑 애플리케이션 및 웹에서 실행됩니다. 각 환경에서 코드 저장소를 읽고 파일을 수정하며 명령을 실행합니다.
IronPPT는 Office Interop 없이 PowerPoint 파일을 생성하고 수정하는 .NET 라이브러리입니다. AddText는 슬라이드에 텍스트를 추가하고, 텍스트 추가 가이드에서 보여주듯이 TextStyle는 무게, 폰트, 크기를 설정합니다. 네 가지 테스트된 프롬프트가 Claude Code를 설정하고 유인물 생성기를 만드는데 기여합니다. 각 프롬프트에 따라 필요한 IronPPT 텍스트 동작이 그 옆에 기록됩니다.
프로젝트 폴더에서 터미널을 열고 claude을 실행한 다음 첫 번째 프롬프트 전에 /model opusplan를 입력하세요. @로 시작하는 경로는 요청에 해당 파일을 첨부합니다.
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.
최소 워크플로우(5단계)
- NuGet에서 C# PowerPoint 라이브러리 다운로드
- 프로젝트 폴더에서 Claude Code를 열고 /model로 모델을 설정하세요.
- 세션마다 로드될 수 있도록 IronPPT의 측정된 텍스트 규칙을 CLAUDE.md에 기록하세요.
- 모든 텍스트 상자를 위치시키고 모든 스타일을 집 스타일 파일에서 가져오는 생성기를 요청하세요.
- 유인물이 인쇄되기 전에 저장된 슬라이드 XML을 스타일 파일과 비교하세요.
.NET 프레젠테이션 프로젝트에서 Claude Code가 하는 일은 무엇인가요?
에이전트는 생성기를 작성하고, 개요 파일을 읽으며 모듈별로 하나의 덱을 구성하고 저장된 모든 덱을 스타일 파일과 비교 검토합니다. 검사가 실패하면, 생성기 오류 보고서를 읽고 수정한 후 다시 실행합니다. 개발자는 집 스타일과 각 슬라이드의 텍스트를 결정합니다.
첫 번째 프롬프트는 IronPPT 패키지의 이름과 버전을 지정합니다. 패키지 이름 선택 에이전트가 악의적 인물이 등록한 패키지를, AI 도구가 생성했던 이름을 사용해 설치할 수도 있습니다. 이 공격은 슬롭스쿼팅으로 알려져 있습니다.
Claude Code를 어떻게 설정하나요?
Anthropic의 빠른 시작을 따라 Claude Code를 설치하고 로그인하세요. claude이 터미널에서 시작하고 응답하면 설정이 완료됩니다.
Claude Code가 작업할 수 있는 프로젝트를 어떻게 설정하나요?
첫 번째 프롬프트 전에 에이전트에게 실제 입력을 제공하세요. 테스트 픽스처는 두 개의 모듈 개요와 집 스타일 파일을 보유한 코스 폴더가 있는 .NET 9 콘솔 애플리케이션입니다. 모듈 3 개요는 비동기 및 await에 대해 4개 주제를 다루고, 모듈 4 개요는 LINQ에 대해 3개 주제를 다룹니다. 스타일 파일은 각 유형별로 서체, 크기, 무게, 정렬 및 박스를 포인트로 정의합니다.
CLAUDE.md는 각 세션 시작 시 로드되므로, 거기에 기록된 규칙은 모든 후속 프롬프트에 적용됩니다. 두 번째 프롬프트는 파일과 생성기 코드용 읽기 전용 리뷰어를 생성합니다.
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/agents 폴더가 이미 존재한다면 세션 시작 시, Claude Code가 재시작 없이 새로운 하위 에이전트 파일을 감지합니다. 세션 시작 전에 저장소에 해당 폴더를 생성하세요. 멤버 목록을 넘어서서 가이드를 위해, IronPPT는 llms.txt에서 에이전트용 문서를 나열합니다.
IronPPT 텍스트 규칙 중 CLAUDE.md에 포함해야 할 것은 무엇인가요?
각 라인은 라이선스 키 유무와 관계없이 시도된 실행에서 각각의 저장된 덱이 슬라이드 XML에서 다시 읽힌 결과에서 비롯됩니다. 발표 섹션 아래에 블록을 붙여 넣으세요.
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는 환경 변수 이름을 IronPPT.LicenseKey로 스스로 읽고, 조사에서 IRONPPT_LICENSE_KEY을 무시하는 것으로 발견되었습니다.
IronPPT는 슬라이드에 텍스트를 어디에 배치합니까?
Slide.AddText는 위치가 없는 150 x 100 포인트의 새 모양에 텍스트를 씁니다. 텍스트 추가 가이드의 스크린샷은 첫 번째 슬라이드의 결과를 보여주며 "Hello from IronPPT!"가 왼쪽 상단에 좁은 박스 안에서 세 줄로 감쌉니다. 같은 슬라이드에서 추가로 호출되는 모든 AddText은 위치가 없이 같은 크기의 또 다른 모양을 작성하므로 모양이 겹칩니다.
유인물에서는 각 종류의 텍스트가 정해진 위치에 있어야 합니다. TextBox는 포인트 단위로 Position, Width 및 Height을 허용하며, IronPPT는 오프셋과 크기 조정으로 슬라이드에 씁니다. 슬라이드 자체는 720 x 540 포인트 크기로, 표준 4:3 비율이므로 와이드스크린 덱에 작성된 스타일 파일은 맞지 않습니다.
테스트 실행에서의 모듈 3 유인물 제목 슬라이드는 세 개의 제목 상자를 보여주며, 각각 스타일 파일에서 배치 및 크기가 결정됩니다.

IronPPT가 테스트 실행에서 저장한 모듈 3 유인물의 첫 번째 슬라이드. 슬라이드 XML에서 비율에 맞게 그려지며, 명명된 서체 및 크기로 서술됩니다. 박스 윤곽은 PowerPoint 렌더링이 아닌 드로잉 스크립트에서 나옵니다.
IronPPT가 작성하는 모든 텍스트 박스는 본문 자리 표시자입니다. 본문 자리 표시자가 따르는 슬라이드 마스터의 본문 스타일은 글머리 기호와 32포인트 기본 크기를 정의합니다.
IronPPT는 파일에 어떤 텍스트 스타일을 작성합니까?
IronPPT는 파일에 굵게, 기울임꼴 및 글꼴 크기를 설정한 대로 작성합니다. 조사에서 Font.FontFamily를 Consolas로 설정했지만 실행 속성에는 서체가 없으며 Font.LatinFont는 서체를 작성했습니다.
정렬은 어느 멤버가 그것을 설정하느냐에 달려 있습니다. Paragraph.Alignment 및 Paragraph.SetAlignment 둘 다 중앙에 정렬된 단락을 왼쪽으로 정렬시켰습니다. Paragraph.Style을 ParagraphStyle로 TextAlignmentTypeValues.Center와 함께 설정하여 중심 정렬을 썼습니다. TextAlignmentTypeValues 열거형은 IronPPT.Enums 외부의 전역 네임스페이스에 선언됩니다.
명명된 또는 16진수로 된 모든 색상 실행은 Open XML SDK 검증기를 통과하지 못했는데, IronPPT가 색상 내부가 아닌 옆에 알파 및 채널 값을 작성하기 때문입니다. Color(r, g, b) 생성자는 Save을 던져 NullReferenceException을 발생시켰습니다. Underline은 밑줄 선 속성은 썼지만 밑줄을 켜는 속성은 쓰지 않았습니다. IronPPT의 자체 skill.md는 색상 SetAlignment, TextStyle 및 밑줄을 샘플에서 사용하므로, 이러한 샘플을 복사하는 에이전트는 동일한 결과를 얻습니다.
컴파일 가능한 IronPPT 코드를 어떻게 프롬프트하나요?
한 개의 프롬프트로 생성기와 확인기를 요청하고, 모든 파일 변경 전에 계획 모드로 디자인을 완료하세요. 프롬프트를 보내기 전에 Shift+Tab으로 계획 모드로 전환하세요. opusplan이 선택된 상태에서, Opus는 계획을 작성하고 Sonnet은 계획이 승인되면 구현합니다.
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.
프롬프트의 두 부분이 유인물의 정확성을 유지합니다.
- 단일 소스로서의 스타일 파일: 모든 서체, 크기, 굵기, 정렬 및 박스가 하나의 파일에서 나오므로 확인자는 각 단락을 훈련자가 기록한 값과 비교할 수 있습니다.
- XML을 읽는 확인자: 재로드 후, IronPPT는 슬라이드 XML의 값의 12,700 배로 각 글꼴 크기, 위치 및 박스 크기를 보고하며 모든 정렬은 왼쪽으로 표시됩니다. IronPPT의 리더에 기반한 검사는 올바른 덱에서 실패할 것입니다.
라이선스 키 없이 IronPPT 유인물 코드를 테스트할 수 있나요?
메모리에서 덱을 빌드하고 저장된 덱을 로드하는 것은 모두 키 없이 실행됩니다. 저장만 키가 필요하므로, 테스트 프로젝트는 키가 없는 빌드 에이전트에서 슬라이드 구조 및 확인기를 검토할 수 있습니다.
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.
생성된 IronPPT 코드를 신뢰하기 전에 무엇을 확인해야 하나요?
리뷰에 다음 확인 사항을 포함하세요.
- 빌드:
dotnet build는 존재하지 않는 멤버를 거부합니다. 배포된 IronPPT.xml도 컴파일하고 저장 시 값을 잃는 멤버를 문서화하므로, 성공적인 빌드는 단지 이름이 존재한다는 것을 증명할 뿐입니다. - 슬라이드 XML: 각 단락의 서체, 크기, 정렬 및 박스를 스타일 파일과 비교하세요.
- 인쇄된 유인물 하나: 코스가 시작되기 전에 하나의 덱을 인쇄하고 텍스트 상자가 다른 상자와 겹치지 않는지 확인하세요.
고정된 통과 기준을 갖춘 전체 IronPPT 작업에 대해, 재실행 가능하며, AI 코딩 어시스턴트 가이드를 참조하세요.
실제 실행에서 프롬프트가 무엇을 생성했습니까?
Claude Code는 하나의 세션에서 네 개의 프롬프트를 차례로 실행했습니다. 규칙 블록은 프롬프트 3 전에 CLAUDE.md에 들어갔습니다. 수작업으로 코드를 편집하지 않았습니다.
- 실행 전, 저장소에는 패키지 참조가 없는, 코스 폴더와 한 줄짜리 Program.cs가 있었습니다.
- 퀵스타트 덱에는 3개의 텍스트 상자, 두 개는 비어있는 제목과 부제목 자리 표시자를 포함한 1개의 슬라이드가 있었습니다.
- CLAUDE.md는 다섯 가지 프로젝트 규칙을 받았고 하위 에이전트 파일에는 Read, Grep 및 Glob 도구만 나열되었습니다.
- 프롬프트 3 이후, 모듈 3 유인물에는 5개의 슬라이드가, 모듈 4 유인물에는 4개의 슬라이드가 있었습니다.
- 모든 26개의 텍스트 상자가 스타일 파일이 제공하는 위치 및 크기를 갖고 있었습니다.
- 슬라이드 XML 확인에서 모든 38개의 단락이 서체, 크기, 무게 및 정렬에서 스타일 파일과 일치했습니다.
- 확인자 보고서에는 38개의 행이 포함되어 있었고, 어떤 행도 ‘아니오’로 표시되지 않았습니다.
- Claude Code의 프롬프트 3 자체 요약은 보고서 파일이 보유한 것보다 하나 적은 37개의 행을 제공했습니다.
- 네 개의 선행 공간 및 악센트가 있는 트레이너 이름이 변경되지 않은 채로 슬라이드에 나타났습니다.
- 두 유인물 모두 0개의 오류로 Open XML SDK 검증기를 통과했습니다.
- 생성기는 모든 박스를 위치 잡힌 TextBox로 생성했으며 절대 AddText를 호출하지 않았습니다.
- 하위 에이전트는 위치 없는 텍스트 박스 또는 규칙 목록에 손실된 설정을 찾지 못했습니다.
- 6개의 테스트 중 6개가 IRONPPT_LICENSE_KEY 없이 프로세스에서 통과했고, 새 클론에서도 동일하게 통과했습니다.
- 새 클론에서의 Release 실행에서 동일한 두 유인물 및 동일한 38개의 행이 생성되었습니다.
- 키 없이, 프로그램은 두 모듈을 건너뛰고 헤더만 있는 보고서를 작성했습니다.
- 이 실행의 전사, 세션 파일 또는 저장소 파일에는 라이선스 키가 나타나지 않았습니다.
- 일부 단계는 페이지와 달리 작동했습니다. 세션은 헤드리스로 실행되어 응답에 계획이 나타났고 타이핑된 응답으로 승인되었습니다. 실행의 보호막은 에이전트를 저장소 내에 유지시키며, Claude Code가 사용자 프로필에 저장하려던 계획 파일을 차단했습니다.
모듈 3 유인물에서 슬라이드 3은 두 개의 포인트와 세 줄의 코드가 포함된 두 번째 주제를 보유했습니다.

IronPPT가 테스트 실행에서 저장한 모듈 3 유인물의 슬라이드 3. 슬라이드 XML에서 비율에 맞게 그려지며, 명명된 서체 및 크기로 서술됩니다. 박스 윤곽은 PowerPoint 렌더링이 아닌 드로잉 스크립트에서 나옵니다.
Cursor 가이드에도 에이전트가 먼저 계획을 작성하도록 되어 있으며, Cursor는 이를 편집 가능한 Markdown 파일로 저장합니다. ChatGPT Codex 가이드는 이 가이드가 CLAUDE.md와 마찬가지로 작업 전에 AGENTS.md에 덱 규칙을 보관합니다. 이번 실행의 Claude Code 버전, 모델, 타이밍 및 테스트 머신은 공용 실행 기록에 있습니다.
문제 해결
- 라이선스 키 적용
Save가LicensingException를 던지면 - 저장된 파일에서 누락된 텍스트 스타일을 보고하려면 엔지니어링 지원 요청
질문?
질문이 있으시면 support@ironsoftware.com으로 문의하세요.
커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.