IronQRをClaude Codeで使用する方法
マーケティングチームは、各キャンペーンのQRコードがブランドのネイビーカラーを使用し、ロゴを中央に配置し、ポスターとステッカーの両方のサイズで利用可能であることを求めています。 しかし、スタイリングの選択肢が増えると、スキャンの信頼性が低下する可能性があります。 例えば、ロゴがモジュールを覆うことがあり、明るい前景はコントラストを下げ、小さい印刷サイズはピクセル密度を減少させます。 QRコードは画面上では正しく見えるかもしれませんが、実世界では失敗することがあります。 AnthropicのコーディングエージェントであるClaude Codeは、ターミナル、VS Code、JetBrains、デスクトップアプリケーション、ウェブ上で動作します。 どの環境でも、プロジェクトを読み込み、ファイルを編集し、コマンドを実行するので、スタイル付きコードをレンダリングし、保存されたファイルをデコードし、ペイロードが保持されるまでスタイリングを調整することができます。
IronQRは同じ.NETプロセス内でQRコードを生成し、読み取るので、エージェントは各変更後にスキャンできます。 ライブラリは自動的に読み取れないデザインを拒否します。 手動でサイズを設定したロゴが多すぎる部分を覆ったり、白い背景にあまりにも近い前景色の場合、保存時にIronQrExceptionが発生します。 他のスタイリングする選択肢は成功して保存されても、後でデコードに失敗することがあります。 最も信頼できる方法は、スタイル付きバリアントのマトリックスをテストし、各保存されたPNGをデコードすることです。 このガイドでは、このプロセスのためにClaude Codeを設定する方法と、各プロンプトに依存するIronQRの動作を3つのテスト済みのプロンプトと共に説明しています。
1つのモデル設定が3つのプロンプトすべてをサポートします。opusplanエイリアスは計画モードでOpusを使用し、それ以外ではSonnetを使用します。これは、マトリックスのビルドのみが計画を必要とするセッションに適しています。
ターミナルでプロジェクトフォルダを開き、Claude Codeを開始し、/model opusplanを実行します。 ファイルパスの前に@と入力して、Claude Codeにそのファイルを渡し、それからリクエストを送信します。
Install IronQR from NuGet here and make one branded QR code for the
spring-sale campaign in @Brand/campaigns.json. Use that entry's URL,
foreground color, and background color, put @Brand/logo.png in the center,
and save the result as out/spring-sale.png. Print the saved image's width
and height in pixels first, then open the file again with QrReader and print
the decoded text and whether it equals the campaign URL. The license key is
in the IRONQR_LICENSE_KEY environment variable.
このコードの最も直接的なバージョンは失敗する可能性があります。 当社の探査では、スプリングセールコードがデフォルトのエラー修正レベルで自動的にサイズを設定したロゴで保存され、エラーなしで読み取られませんでした。その後、オブジェクトの破棄された例外をリーダーのデフォルトスキャンモードで投げました。 500ピクセルのコードに手動で100ピクセルのロゴを設定することで、正しく読み取りました。
最初に印刷された幅を確認してください。当社の探査では、サイズ設定のないスタイリングオプションでこのURLの49ピクセルの画像が生成されました。
最小限のワークフロー(5ステップ)
- NuGetからC#用QRコードライブラリをダウンロード
- プロジェクトフォルダでClaude Codeを開始し、
/modelを使用してモデルを選択します。 - 各セッションの開始時にIronQRのスタイルルールを
CLAUDE.mdに記録します。 - レンダーするすべてのバリアントを説明し、エラー修正レベルやロゴのサイズから色、ピクセルサイズまで設定します。
- 保存された各PNGを両方のスキャンモードでデコードします。
.NET QRコードプロジェクトでClaude Codeは何をするのですか?
エージェントはレンダラーを書き、ブランドファイルを読み込み、バリアントごとに1つのPNGを保存し、各ファイルをデコードして、どのデザインが持ちこたえるかを報告します。キャンペーンに必要なバリアントを伝え、戻ってくる表を確認します。
ブランド化されたコードがそのチェックを自動化する価値を持たせる理由は、ロゴのサイズ、修正レベル、ピクセルサイズが相互に影響を与えるからです。 テスト実行では、IronQRは600ピクセルのコードの幅の30%で手動のロゴを保存し、1つのキャンペーンの120ピクセルで同じ比率を拒否しましたが、別のキャンペーンでは逆でした。
最初のプロンプトから唯一のQRライブラリとしてIronQRを名付けます。 パッケージ名を推測するエージェントは、その推測を捉えるために公開された似たものをインストールする可能性があります。この攻撃をスロップスカッティングと呼びます。
Claude Codeをどのように設定しますか?
AnthropicのクイックスタートでClaude Codeをインストールしてサインインします。 ターミナルで開始して応答すると、準備が完了しています。
プロジェクトClaude Codeが作業できるようにするにはどうすればよいですか?
最初のプロンプトの前にリポジトリを準備します。 .NET 9コンソールプロジェクトをビルドし、各キャンペーンのURLと色を含むBrand/campaigns.jsonファイルを作成し、ロゴファイルを用意してエージェントに実際の入力を提供します。 そのフォルダからClaude Codeを開始し、セッションをそれに限定します。
Claude Codeは各セッションの開始時にCLAUDE.mdを読み込むので、それ以上のプロンプトを超えて存続すべきルールの場所となっています。 Quickstartでパッケージが追加された後、2番目のプロンプトがファイルを書き込みます。
Write CLAUDE.md in the repository root with a section called QR codes. It
should tell every later session that IronQR (NuGet package IronQR, pinned to
the version now in BrandQr.csproj, namespaces IronQr and IronQr.Enum) is the
only QR library allowed here; that IronQR member names are checked against
IronQr.xml inside the ironqr.slim folder of the local NuGet cache before use;
that QrStyleOptions is always given an explicit Dimensions and Margins; that
the key comes only from IRONQR_LICENSE_KEY at startup and is never written to
a file or printed; and that a QR image counts as finished only after the saved
PNG has been decoded back to its exact payload.
XMLパスは重要です。なぜなら、スタイリングと読み取りタイプがIronQR.Slimパッケージに含まれており、それにIronQRが依存しているため、メンバーリストはそのキャッシュのフォルダにあります。 メンバーリストの他のガイドについては、IronQRがllms.txtにエージェント向けのインデックスを公開しています。
最初のレンダリング前にライセンスを処理します。 キーがない場合、QrWriter.Write または QrReader.Read が "Production License Required" というメッセージを伴ってLicensingExceptionをスローします。フォールバックとしての透かし付きトライアル出力はありません。 その例外タイプは公開されていないため、License.IsLicensedをチェックし、IRONQR_LICENSE_KEYからキーを設定した後に例外をその名前でキャッチするのではなく、プログラムにチェックさせます。 IronQRライセンスキーのページでは、キーの取得方法とIronQRがそれを読み取る場所について説明しています。
IronQR設定をCLAUDE.mdに含めるべき項目はどれですか?
各行は、ライセンス済みのキーを使ってプローブをビルドするか、プローブを実行することにより、IronQR 2026.10.1に対して確認されました。 QRコードセクションの下にブロックをペーストします。
## QR codes: IronQR 2026.10.1 behavior
- new QrStyleOptions { ... } starts at Dimensions 0 and margins 0, which
renders one pixel per module. The constructor with arguments defaults to
300 and 10. Always set both.
- Margins are added outside Dimensions. Dimensions 600 with Margins 24
saves a 648 x 648 PNG. Margins has no getter, so read MarginTop and the
other sides.
- QrErrorCorrectionLevel.High is level Q (about 25 percent) and Highest is
level H (about 30 percent). QrWriter.Write without options uses Highest.
- Build QrOptions with its constructor. An object initializer leaves
Encoding at None, and Write throws IronQrEncodingException.
- QrLogo width and height 0 let IronQR choose the logo size. A manual size
it cannot read back throws IronQrException from Save.
- Save checks a changed foreground color. It does not check a changed
background color.
- qr.Verify(expected) takes the expected text, not a file path.
- Save(style) keeps the style on the QrCode, so a later Save() repeats it.
- Do not put QrImageInput in a using block. Its explicit IDisposable.Dispose
throws NotImplementedException after a successful read. Its public
Dispose() works.
- Read every saved PNG with QrScanMode.Auto and QrScanMode.OnlyBasicScan.
黒いモジュールが黒い背景に保存されても例外が発生せず、どちらのスキャンモードでもファイルをデコードできませんでした。
どのようにしてQRコードのサイズ、マージン、および色を制御しますか?
1つのQrStyleOptionsオブジェクトがすべてのビジュアル選択を保持します。Saveがそれを適用し、ディスクにSaveAsで書き込むビットマップを返します。 エラー修正レベルはQrOptionsにのみ存在する設定で、これはエンコードされるシンボル自体を変更するからです。
Dimensionsはピクセル単位でコードサイズを設定し、Marginsは四辺の静寂地帯を設定し、MarginTopと他の側面は各側面を設定します。 Colorは暗いモジュールを描き、BackgroundColorは明るい領域とマージンを描きます。 Logoはビットマップ、幅、高さ、コーナーの半径を持つQrLogoを取ります。
当社の探査では、トップとボトムマージンが50ピクセル、左右のマージンが20ピクセルの400ピクセルコードが440 x 500で保存されました。リサイズガイド、マージンガイド、カラーガイドは、それぞれの設定を単独で示しています。
Saveを呼び出すと250 x 250の画像が返されます。 そのサイズは内部のデフォルトサイズです。各エラー修正レベルでロゴはどれくらい大きくできるのですか?
修正の割合が示唆するよりも小さいです。これらの数値は、リード-ソロモンのデコードが再構築できるコードワードを数え、中央ロゴは損傷の唯一の原因ではありません。 IronQRがそれを保存することを拒否するまで、平方ロゴを自動サイズ設定して、1%ずつ手動サイズを上げました。
| レベル | 文書化された回復 | 自動ロゴ(幅、面積) | 最大手動ロゴ(幅、面積) |
|---|---|---|---|
| 低レベル | 7% | 20%、4.0% | 23%、5.3% |
| 中規模 | 15% | 30%、9.0% | 31%、9.6% |
| 高い | 25% | 32.5%、10.6% | 39%、15.2% |
| 最高 | 30% | 32%、10.2% | 44%、19.4% |
2026.10.1アセンブリでは、自動サイズ設定はコード幅の分数の短いリストを試し、半分から20分の1まで試し、デコードした最初のものを保持します。 そのリストがHighとHighestが幅の約3分の1近くに位置する理由を説明しています。 手動サイズはさらに高く、面積で文書化された回復の60%から75%程度まで上がりますが、IronQRは自社のリーダーでフル解像度でそれをチェックします。 2番目のスキャンモードではそのチェックが通過しても失敗することがあります。
数値はペイロードに依存します。 より長いURLは異なる限界を持つより密なシンボルを生成するため、テーブルをトレードオフの形として扱い、マトリックスで独自のキャンペーンを測定しましょう。
1つのプロンプトでスタイル付きのIronQRバリアントすべてをテストするにはどうしますか?
1つのプロンプトでグリッド全体を求め、デザインを計画モードで最初に決定します。ステータスバーに計画モードと表示されるまでShift+Tabを押してからプロンプトを送信します。
Build Services/BrandedQrRenderer.cs, which renders one campaign from
@Brand/campaigns.json for a given QrErrorCorrectionLevel, logo mode, and
pixel size, and Services/ScanMatrix.cs, which renders every campaign at every
correction level (Low, Medium, High, Highest), with three logo modes (no
logo, a QrLogo of width and height 0 so IronQR sizes it, and a manual logo 30
percent of Dimensions wide that keeps the logo's aspect ratio), at the poster
and sticker sizes in the JSON. Call the matrix from Program.cs after the
spring-sale code. Save each PNG under out/matrix/. Decode every saved file
twice with a new QrReader each time, once with QrScanMode.Auto and once with
QrScanMode.OnlyBasicScan, and catch exceptions per file, including any that
Save throws. Write out/scan-matrix.csv with campaign, level, logo mode, size,
image width and height, the save result, and both read results, then print
how many variants decode to the exact URL in both modes. When the matrix has
run, have the general-purpose subagent check every IronQR member in the new
files against IronQr.xml and list any it cannot find.
各条項は、結果が実際よりも良くなる可能性を閉じます。
- すべての組み合わせが命名されています:3つのキャンペーン、4つのレベル、3つのロゴモード、2つのサイズが72のバリアントを作るので、
out/scan-matrix.csvの欠落した行が表示されます。 - 保存失敗は行です:拒否された保存は結果と見なされ、それらの行はロゴのサイズ制限がどこにあるか示します。
- 各リードに新しいリーダー:失敗したリードが次に影響を与えることはありません。
- 2番目のエージェントはAPIをチェックする:一般目的のサブエージェントが
CLAUDE.mdをロードし、組み込みのExplorationとPlanのサブエージェントがスキップするので、チェックがプロジェクトのルールを確認します。
生成されたIronQRコードを信頼する前に確認すべきことは何ですか?
QrScanMode.Autoは検出モデルが何も見つけないときのみ基本スキャンにフォールバックし、列挙の自身の文書化において検出モデルの後に、検出されない場合は基本的な力ずくの読取りと記載されています。 モデルがコードを見つけたがデコードできない場合、Autoは空の結果を返し、基本スキャンは実行されません。
基本スキャンは上記で失敗したすべてのQuickstartバリアントをデコードし、例外はIronQR 2026.10.1の内部から来ています。完全なマトリックスの調整実行において、Autoが見逃したすべてのファイルにはロゴがついており、8つのうち6つはロゴに費やす冗長性の最も多い2つのレベル、HighまたはHighestにありました。 テストされた実行では、エージェントが選んだ10ピクセルのマージンで8つのAutoの見逃しのうち2つはロゴがまったくありませんでした。
同じレビューにこれらのチェックを追加します。
- ビルド: 発明したメンバーは
dotnet buildに失敗し、IronQRとスペルされたusingディレクティブも同様で、パッケージの大文字を使用しながらネームスペースはIronQrです。 - サイズ: 各保存された幅を要求されたサイズと両サイドのマージンで比較します。 不一致は一度も保存呼び出しに到達しなかったスタイルを示します。
- ペイロード: ディスク上のファイルをデコードします。
VerifyはテキストをIronQRのメモリ内レンダリングと比較し、ファイルパスがfalseを返し、間違ったスタイルで書き込まれたファイルは気付かれません。
チェックサムとフォールトトレランスガイドでは、損傷したコードの読み取りと戻ってくるものの検証について説明しています。 IronQRタスクの完全な実行のエンドからエンドまでの独自の合格基準を備えたものについては、AIコーディングアシスタントガイドを参照してください。
プロンプトが実運用で生成したものは何ですか?
上記の3つのプロンプトを1つのセッションで順にClaude Codeに送信しました。 ブランドファイルには、3つのキャンペーン、600ピクセルのポスターサイズ、120ピクセルのステッカーサイズ、正方形のロゴと広いワードマークが含まれていました。 クリーンコピーのリリースビルドを別途行い、その後、マトリックスを再度実行し、同一のCSVを書き、保存されたすべてのPNGの独立したデコードが各行に同意しました。
- 初回の実行で、マトリックスは両方のモードで72のバリアントのうち0に一致しました。 Claude Codeが
QrImageInputのusingブロックを削除した後、72のうち55が一致しました。 - IronQRは保存時に9つのバリアントを拒否し、すべて手動でのロゴがありました。 保存された63ファイルのうち、基本スキャンはすべて63をデコードし、Autoは55をデコードしました。
- Quickstartでは、Claude Codeは10ピクセルのマージンと50 x 50のロゴを持つ300ピクセルのコードを選択しました。 その320 x 320 PNGは最初の読み取りでURLに一致しました。
- サブエージェントは
IronQr.xmlにIronQRメンバーが欠けていることを見つけませんでした。 - 各プロンプトは、手動編集なしにクリーンなリリースビルドを残し、マトリックス合計は校正実行と equalでした。
- タイプされた応答が計画ダイアログに代わって3番目のプロンプトの計画を承認しました、セッションがインタラクティブではなく実行されたため。
このガイドとそのきょうだい用のバージョン、モデル、タイミング、テストマシンは、共有実行記録にあります。
トラブルシューティング
- ビルドが成功し、最初の書き込みがライセンス例外をスローする場合はIronQRにライセンスキーを適用します。
- 手動でサイズ変更されたロゴの保存がIronQrExceptionをスローする場合はQRコードにロゴを追加します。
- バリアントがロゴのためにより多くの冗長性を必要とする場合はQRコードのエラー修正レベルを設定します。
質問ありますか?
質問がある場合は、support@ironsoftware.com にお問い合わせください。
Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。