IronPPTをClaude Codeで使用する方法

Curtis Chau
Curtis Chau
更新日: 2026年10月19日

研修会社は、C#コースの各セッションに対してPowerPointのハンドアウトを発行します。 各モジュールには、そのトピックの概要ファイル、各トピックのポイント、コードサンプル、時折の警告、および各種のテキストのフォント、サイズ、位置を固定するハウススタイルファイルがあります。 デッキが手作業で組み立てられると、誤ったフォントや重なったテキストボックスは、研修生がハンドアウトを印刷するまで気づかれないことがあります。 Claude Codeは、Anthropicのソフトウェアエージェントで、ターミナル、VS Code、JetBrains、デスクトップアプリケーション、およびウェブで実行されます。 各環境で、リポジトリを読み込み、ファイルを修正し、コマンドを実行します。

IronPPTはOffice InteropなしでPowerPointファイルを作成および編集する.NETライブラリです。AddTextはスライドにテキストを追加します。これはテキストを追加するガイドに示されています。また、TextStyleはその重さ、フォント、サイズを設定します。4つのテスト済みプロンプトがClaude Codeをセットアップし、ハンドアウト発行ジェネレーターを構築します。 各プロンプトが依存するIronPPTテキストの動作がその横に記録されています。

クイックスタート
NuGetNuGet でインストール

PM > Install-Package IronPPT

NuGetパッケージマネージャーコンソールで上記のコマンドを実行するか、NuGetパッケージマネージャーでパッケージを検索して、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.
Text


NETプレゼンテーションプロジェクトでClaude Codeは何をするのですか?

エージェントは生成器を書き、トピック概要ファイルを読み込み、各モジュールに1つのデッキを作成し、保存された各デッキをスタイルファイルと照合します。チェックが失敗した場合、生成されたレポートを読み、生成器を修正し、再実行します。 開発者はハウススタイルと各スライドのテキストを決定します。

最初のプロンプトはIronPPTパッケージとそのバージョンを指定します。 エージェントにパッケージ名の選択を任せた場合、AIツールが生成するが実際には使用されていない名前で攻撃者が登録したパッケージをインストールする可能性があります。 この攻撃はスロップスキャッティングとして知られています。

Claude Codeをどのように設定しますか?

Anthropicのクイックスタートに従ってClaude Codeをインストールし、サインインします。 ターミナルでclaudeが開始し、応答するとセットアップが完了します。

プロジェクトClaude Codeが作業できるようにするにはどうすればよいですか?

最初のプロンプトの前にエージェントに実際の入力を与えます。 テストフィクスチャは.NET 9コンソールアプリケーションで、コースフォルダには2つのモジュール概要とハウススタイルファイルが含まれています。モジュール3の概要は4つのトピックで非同期とawaitをカバーし、モジュール4の概要は3つのトピックでLINQをカバーします。 スタイルファイルは、フォント、サイズ、重さ、配置、ポイント単位のボックスを持つ7つのテキストロールを定義します。

CLAUDE.mdは各セッションの開始時にロードされるため、そこに書かれたルールはその後のすべてのプロンプトに適用されます。 2番目のプロンプトは、ファイルと生成器コードのレビュー用のリードオンリーリポジトリを作成します。

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は再起動せずに新しいサブエージェントファイルを検出しますが、.claude/agentsフォルダがセッションの開始時に存在している必要があります。 セッションを開始する前にリポジトリにそのフォルダを作成します。 メンバーリストを超えるガイドについては、IronPPTはエージェント向けのドキュメントをllms.txtに記載しています。

CLAUDE.mdにはどのIronPPTテキストルールが含まれていますか?

各行は、ライセンスキーとなしで実行されたプローブから来ており、保存された各デッキがスライド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.
Markdown

IronPPTはIronPPT.LicenseKeyという環境変数を自分で読み取り、プローブはそれがIRONPPT_LICENSE_KEYを無視することを発見しました。

IronPPTはスライドのどこにテキストを配置しますか?

Slide.AddTextは150 x 100ポイントの位置を持たない新しい形状にテキストを書き込みます。 追加テキストガイドのスクリーンショットは、最初のスライドでの結果を示しており、「Hello from IronPPT!」が左上の狭いボックスに3行で折り返されています。 同じスライドでのAddTextの呼び出しは、同じサイズの位置を持たない別の形状を書き込むため、形状が重なります。

ハンドアウトは各テキストを固定された場所に配置する必要があります。 TextBoxはPosition、Width、Heightをポイントで受け入れ、IronPPTはそれらをスライドにオフセットと範囲として書き込みます。 スライド自体は720 x 540ポイント、標準の4 x 3サイズであるため、ワイドスクリーンデッキ用に書かれたスタイルファイルは適合しません。

テストランからのモジュール3ハンドアウトのタイトルスライドは、スタイルファイルから配置されサイズが設定された3つのタイトルボックスを示しています。

スライドXMLからスケールアップされたモジュール3ハンドアウトのタイトルスライド

テストランでIronPPTが保存したモジュール3ハンドアウトのスライド1です。スライド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コードをプロンプトするにはどうすればよいですか?

生成器とそのチェッカーを1つのプロンプトでリクエストし、設計がすべてのファイル変更の前に完了するようにプランモードを許可してください。 プロンプトを送信する前に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.
Text

プロンプトの2つの部分がハンドアウトを正しく保ちます。

  1. 唯一のソースとしてのスタイルファイル:すべてのフォント、サイズ、重さ、配置、およびボックスが1つのファイルから来ているため、チェッカーは各段落をトレーナーが書いた値と照合することができます。
  2. XMLを読むチェッカー:リロード後、IronPPTはスライドXMLの12,700倍の値で各フォントサイズ、位置、ボックスサイズを報告し、すべてのアラインメントを左とします。 IronPPTのリーダーに基づいたチェックは正しいデッキで失敗します。
ヒント: すべてのボックスが配置されたTextBoxで、すべての書体がLatinFontを介して設定された場合のみ計画を承認します。

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.
Text

生成したIronPPTコードを信頼する前に何を確認すべきですか?

レビューに以下のチェックを含めます。

  • ビルド:dotnet buildは存在しないメンバーを拒否します。出荷されたIronPPT.xmlもコンパイルされ保存時に値を失うメンバーを文書化しており、成功したビルドは名前が存在することを証明するだけです。
  • スライドXML:各段落のフォント、サイズ、配置、ボックスをスタイルファイルと比較します。
  • 印刷された1つのハンドアウト:コースが始まる前に1つのデッキを印刷し、テキストボックスが互いに重なっていないことを確認します。

固定パス基準を持つ完全なIronPPTタスクで再実行可能なものはAIコーディングアシスタントガイドを参照してください。

プロンプトが実運用で生成したものは何ですか?

Claude Codeは4つのプロンプトを1つのセッションで順に実行しました。 ルールブロックはプロンプト3の前にCLAUDE.mdに入りました。コードは手で編集されていません。

  • 実行前に、リポジトリはコースフォルダと1行のProgram.csを持っており、パッケージ参照はありませんでした。
  • クイックスタートデッキには1つのスライドと3つのテキストボックスがあり、そのうち2つは空のタイトルとサブタイトルのプレースホルダーでした。
  • CLAUDE.mdは5つのプロジェクトルールを受け取り、サブエージェントファイルにはRead、Grep、Globツールのみがリストされていました。
  • プロンプト3の後、モジュール3ハンドアウトには5つのスライドがあり、モジュール4ハンドアウトには4つありました。
  • すべての26のテキストボックスはスタイルファイルが与える位置とサイズを持っていました。
  • スライドXMLのチェックでは、すべての38段落がフォント、サイズ、重さ、配置でスタイルファイルと一致していました。
  • チェッカーのレポートには38行があり、noとマークされた行はありませんでした。
  • Claude Codeのプロンプト3の独自要約には、レポートファイルに含まれるより1行少ない37行がありました。
  • 四つの先頭スペースとアクセント付きトレーナー名を持つコード行はスライドで変更なしで表示されました。
  • 両方のハンドアウトがOpen XML SDKのバリデーターに0エラーで合格しました。
  • 生成器はすべてのボックスを配置されたTextBoxとして作成し、AddTextを呼び出すことはありませんでした。
  • サブエージェントは位置なしのテキストボックスもルールリストで失われたとされる設定も見つけませんでした。
  • 6つのテストのうち6つがIRONPPT_LICENSE_KEYなしでのプロセスで合格し、新しいクローンでも再び合格しました。
  • 新しいクローンでのリリース実行は同じ2つのハンドアウトと同じ38行を生成しました。
  • キーなしで、プログラムは両方のモジュールをスキップし、ヘッダーと行を持たないレポートを書き込みました。
  • ライセンスキーはこの実行のトランスクリプト、セッションファイル、またはリポジトリファイルに表示されませんでした。
  • 一部のステップはページと異なる方法で実行されました。 セッションはヘッドレスで実行され、応答にプランが表示され、タイプされた応答がそれを承認しました。 実行のガードは、エージェントをリポジトリ内に保つもので、Claude Codeがユーザープロファイルに保存しようとしたプランファイルをブロックしました。

モジュール3ハンドアウトで、スライド3は2番目のトピックを保持し、その2つのポイントと3行のコードを含んでいました。

スライドXMLからスケールアップされたモジュール3ハンドアウトのスライド3

テストランでIronPPTが保存したモジュール3ハンドアウトのスライド3です。スライドXMLからスケールアップされ、指定されたフォントとサイズで描かれています。ボックスのアウトラインは描画スクリプトに由来し、これはPowerPointのレンダリングではありません。

Cursorガイドは、エージェントが最初にプランを書き、Cursorが編集可能なMarkdownファイルとして保存することを前提としています。ChatGPT Codexガイドは、デッキルールをAGENTS.mdに保持し、Codexが作業する前にそれを読み込み、CLAUDE.mdでこのガイドが行うのと同様です。 この実行のClaude Codeバージョン、モデル、タイミング、テストマシンは、共有される実行記録にあります。


トラブルシューティング


質問ありますか?

質問がある場合は、support@ironsoftware.com にお問い合わせください。

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

もっと読む

準備はできましたか?

NuGetダウンロード数 7,110バージョン:2026.11ちょうどリリースされました