IronBarcodeの作業をClaude Codeに委任する
バーコードタスクの成否を左右するのは3つの事実です。NuGetパッケージ名はBarCodeで、ライセンスキーは環境から取得し、生成した画像をデコードして書き込んだ値と照合するまで作業は完了しません。Claude Codeは、このシリーズの中で、これらの事実をプロンプトではなくリポジトリに保持するツールです。会話の開始時にCLAUDE.mdを読み込み、バーコードのコードを扱うタスクでは.claude/skills/ironbarcode/SKILL.mdを読み込みます。IronBarcodeが公開するskill.mdは、この場所に配置して使うためのファイルです。
これらのルールは、読み込むモデルに関係なく適用されます。コストを大きく左右するのはモデルの選択です。/model sonnetオプションは、ラベルサービスの実装やテストセットの実行など、ほとんどのバーコードタスクに十分です。/model opusplanオプションは計画にOpus、実装にSonnetを使用し、コードの対応付けが重要な複雑な移行に役立ちます。Fable 5.1を指定するfableエイリアスと、単純なタスク向けのhaikuエイリアスも利用でき、セッション中にモデルを切り替えられます。
1つのパッケージで作業全体をまかなえることは、人間以上にエージェントにとって重要です。 1Dと2Dの書き込み、1つの画像から複数のバーコードを読み取る、およびマルチスレッド読み取りは同じAPIで行えるため、別のライブラリを追加する承認を求めて作業を中断する必要がありません。GeneratedBarcode.Verifyは生成直後の画像をデコードして値を照合するため、このラウンドトリップをタスク自体に組み込みます。
選択したティアは生成されたコードとコストの両方に影響します。同じプロンプトを異なるモデルに提供すると、クラス名、オプションのレイアウト、テスト構造を含む異なる実装が得られます。 一貫性のある出力を得るには、エンコーディング、ピクセル寸法、および成功した読み取りと見なされる要素を固定し、その他はモデルに選ばせます。
クイックスタート.NETプロジェクトでセッションを開始し、実装の詳細よりも要件を中心に、必要なバーコードを指定します。
Bring in the BarCode package, then write a console app that decodes every PNG
in @TestData/inbox/ at once rather than one at a time. Use BarcodeReader.ReadAsync with
ExpectMultipleBarcodes enabled and MaxParallelThreads set to the core count.
Take the license from IRONBARCODE_LICENSE_KEY. Print each file name with the
values found in it, and print how long the whole batch took.
Claude Codeは残りの手順を実行します。パッケージを追加し、非同期読み取りを実装し、プロジェクトをビルドしてコンパイルエラーを解消し、結果を報告します。コードの変更と計測時間を確認してください。非同期とマルチスレッドガイドでは、使用すべきオプションを説明しています。
未指定の詳細は自動的に決定されます。 シンプルな例の場合、これは許容範囲です。なぜなら、最新のパッケージとデフォルト設定が使用されるからです。 本番作業のためには、次の3つの制約をプロンプトに設定してください:
- バージョンを指定する: IronBarcodeリリースの名前を指定し、エージェントが単一のAPIサーフェスに対してコーディングするようにします。
- 依存関係を制限する:
BarCodeパッケージのみを許可し、追加のバーコードライブラリを導入しないようにします。 - エージェントが停止できるようにする: 文書化されたAPIのみを使用し、不確かである場合は知らせるように指示します。
5つのステップでミニマルワークフロー
- NuGetからC#バーコードライブラリをダウンロード
- プロジェクトルートからClaude Codeセッションを開始し、エージェントが既存のコードベースにアクセスできるようにします。
- すべてのセッションで適用されるように制約を
CLAUDE.mdに文書化します。 - プロンプトにシンボロジー、入力値、および再読み取りで期待する結果を含めます。
- プロジェクトをビルドし、ラウンドトリップを実行し、APIリファレンスを元に各API名を確認します。
バーコード作業のどの部分を委任するべきですか?
Claude Codeは主に日常的な開発タスクを処理します。どのインターフェースからでも、コードの読み書きやリファクタリング、ビルドの実行、テストの反復を管理できます。バーコードの生成とスキャンも、特別な設定なしでこの流れに組み込めます。
バーコードタスクに関しては、Claude Codeが反復作業を管理します。ラベルサービスを書くこと、スキャンのエンドポイントを作成すること、必要な形式でテスト画像を生成し、それらを読み取ることです。 無効なEAN-13チェックデジットのような問題を検出して修正し、必要に応じて再構築し、エラー後に再試行します。 バーコード仕様を提供し、その結果のコード変更を確認してください。
バーコードライブラリの選択は開発者の責任です。指定しない場合、エージェントは学習時に最もよく目にしたものを選ぶため、次の4つの問題が生じます。
- シンボルのサイズとチェックデジット:小さすぎるシンボル、クワイエットゾーンの不足、誤ったチェックデジットは、見た目が正しくてもスキャンに失敗する原因になります。IronBarcodeは生成時にシンボロジーごとの値を検証します。
- トークン量が料金を左右する:エージェントが独自のデコーダーを構築すると、操作のたびにトークンを消費します。一方、マルチスレッド読み取り、速度プリセット、画像フィルターは、すでに調整され、文書化されています。
- カスタムパイプラインには検証がありません:それらは大規模なデータセットや公開されたベンチマークに対してテストされていませんが、繰り返し可能なラウンドトリップテストを持つ文書化されたAPIとは異なります。
- パッケージ名はセキュリティ対策にもなる:
dotnet add package IronBarcodeではIronBarcodeはインストールされません。また、類似した名前のパッケージが悪意のある者によって登録されています。
エージェントが推測せずに済むように、プロンプトでBarCodeを指定してください。
一度パッケージを指定すると、その後のタスクではライブラリの選択が不要になります。
新規インストールから初めてのバーコードプロンプトまでのステップは何ですか?
アプリケーションをインストールし、Claudeアカウントでサインインし、準備が整いました。 AnthropicのClaude Codeオーバービューはツールの詳細な説明を提供します。 クイックスタートガイドでは、インストールとmacOS、Windows、およびLinuxでの初セッションをカバーしており、IDEを好む人向けにVS CodeとJetBrains拡張機能のページも用意されており、AnthropicのYouTubeチャンネルでは初セッションのビデオウォークスルーも提供しています。
claudeが開始して応答可能になったら戻ってください。
Claude Codeが作業できるプロジェクトを設定するには?
標準的な.NETプロジェクトを作成し、エージェントで開く前にIronBarcodeを追加します。 プロジェクトが事前に正常にビルドされることを確認することで、混乱を排除し、エージェントがどのバーコードライブラリや類似名のパッケージを使用すべきか推測するのを防ぎます。
dotnet new console -n LabelScanDemo
cd LabelScanDemo
dotnet add package BarCode --version 2026.9.2
claude
最終コマンドは現在のフォルダにセッションを開き、エージェントの読み取りと編集をそのディレクトリに制限します。 Anthropicのドキュメントはこのアプローチを推奨しています。 プロジェクトディレクトリに移動してからCLIを起動してください。 ターミナル、IDE拡張機能、デスクトップアプリ、ウェブを含むすべてのインターフェースは同じエンジンを使用します。その結果、CLAUDE.mdファイル、プロジェクト設定、およびプロジェクト用に構成されたMCPサーバーがセッション全体で一貫していることが保証されます。
2つの追加の詳細は後で役立ちます:
CLAUDE.md: Claude Codeが各セッションの開始時に読み込む指示ファイルです。対象のフレームワーク、BarCodeパッケージ、文書化されたAPIのみを使用するというルールを記載します。- IronBarcodeのドキュメントインデックス:
llms.txtはエージェントが解析できる形式で実際のドキュメントURLを一覧表示し、skill.mdは一般的な失敗のための検証済みのレシピと修正を追加します。
Claude Codeはリポジトリ内の.claude/skills/<name>/SKILL.mdからスキルを読み込みます。IronBarcodeのファイルを.claude/skills/ironbarcode/SKILL.mdとして保存し、コミットします。フロントマターのdescriptionのみがコンテキストに残り、関連するタスクが発生したときにClaudeが本文を読み込みます。これにより、バーコード作業が始まるまでのオーバーヘッドを最小限に抑えられます。さらに対象を絞るには、Services/**などのpathsグロブを追加し、必要なファイルにエージェントがアクセスしたときだけスキルを読み込むようにします。
両方のファイルが揃っていることで、エージェントは記憶に頼る代わりにドキュメントを参照します。 単一プロンプトで必要なファイルを生成できます。
Write me a Barcodes section for CLAUDE.md and append it to the file, creating
the file if there isn't one. Cover these rules, in your own words, as
instructions to yourself in future sessions:
- IronBarcode (NuGet package BarCode, namespace IronBarCode) handles all
barcode work here. No other barcode package gets added.
- Consult https://ironsoftware.com/barcode/csharp/llms.txt first. Anything not
on a page it lists does not go in the file. Load
https://ironsoftware.com/barcode/csharp/skill.md as a skill file.
- The license key comes from IRONBARCODE_LICENSE_KEY. Never inline it.
- A barcode task ends when the saved image has been read back and the decoded
string matches the input, not when the code compiles.
Then show me the section you added and tell me whether this repository also has
an AGENTS.md you should be reading alongside it.
最初の実行前にライセンスを設定してください。IronBarcodeは開発猶予期間が終了すると、透かしを付ける代わりにLicensingExceptionをスローします。起動時に、バーコードを扱う処理より前に環境からキーを取得してください。IronBarcodeのライセンスキーのドキュメントでは、キーの取得と適用方法を説明しています。
コンパイル可能なIronBarcodeコードを求めるにはどうしたらよいですか?
エージェントが推測しがちな3つの要素、シンボロジー、値の取得元、成功の基準を指定してください。
プロンプトを仕様として記述します。
Press Shift+Tab first so this runs in plan mode, and show me the plan before anything touches disk. Then create Services/LabelService.cs with a method that turns a tracking number into PNG bytes. The symbol is Code 128, the image is 400 wide by 120 tall, and the human-readable number sits underneath it. Then create Services/ScanService.cs with an async method that reads a Code 128 barcode from an image path and returns the value, or null when nothing is found. Add a console check that writes three tracking numbers, reads each back, and prints whether they match. Use only methods documented at ironsoftware.com/barcode/csharp. If unsure of a method name, stop and ask.
このプロンプトで重要なのは、次の3点です。
- ファイルパス:プロンプトがこれらを名前で指定するため、エージェントが考案したものではなく、ナビゲート可能なプロジェクト構造を得ることができます。
- 生成側と読み取り側のシンボロジー:両方でCode 128を使用するため、読み取り側が形式を推測する必要がなくなります。
- 完了はラウンドトリップとして定義:エージェントは書き込まれた値が読み取られた値と一致することを確認します。これはバーコードの外観を確認するより優れています。
CLAUDE.mdにコピーするようにClaude Codeに指示します。 将来のセッションではこれらの制約が自動的に読み込まれます。生成されるコードは簡潔になるはずです。BarcodeWriter.CreateBarcodeにBarcodeEncoding.Code128を指定し、ResizeTo、AddBarcodeValueTextBelowBarcode、SetMarginsでラベルのサイズ調整、値の印字、クワイエットゾーンの追加を行います。ToPngBinaryDataでバイト列を生成し、ExpectBarcodeTypesをCode 128に設定したBarcodeReader.ReadAsyncで読み取ります。生成ファイルではなく実際のスキャン画像を扱う場合は、Speed、CropArea、画像フィルターなどのオプションがさらに重要になります。バーコードリーダーチュートリアルでこれらを説明しています。
Claude CodeはMCPを通してIronBarcodeに接続できますか?
Claude Codeは、オープンスタンダードであるモデルコンテキストプロトコル(MCP)を通じて外部ツールと統合します。 MCPサーバーは、モデルがトレーニングで見たことのないツール、データベース、APIを公開することができ、一つのCLIコマンドでサーバーを追加できます。詳細はMCPリファレンスを参照してください。
IronBarcodeはサーバーを必要としません。 その統合はドキュメンテーションで構成されており、3つのURLとして公開されています。 llms.txtがドキュメントをインデックスします。 skill.mdファイルには、検証済みのレシピと共通の失敗が含まれています。 APIリファレンスは、リリース内のすべてのクラスとメンバーをリストしています。 これを読むことで、エージェントは記憶されたAPIではなく現在の情報を取得します。これは、MCPサーバーがしばしば解決する古いメソッドの情報に基づく問題と同じものです。 実行するプロセスはなく、維持する設定や、ドキュメントがアップデートされたときに再起動の必要もありません。 エージェントはそのセッション中にページを単に取得します。
3つのソースを直接貼り付けるか、CLAUDE.mdから参照して、プロジェクトのコンテキストに追加してください。セッション内のすべてのプロンプトで利用できます。
生成されたバーコードコードを信頼する前に何を確認すべきですか?
毎回、すべてのAPI名とバーコードを確認してください。確認のコストが低い順に、次の4つの手順を実行します。
- ビルドが通る:差分を読む前に
dotnet buildを実行します。実在しないメンバーがあれば、数秒でエラーになります。 - 各メンバーが存在する: 見覚えのないクラスやメソッドはすべてAPIリファレンスで検索し、
DatabarとDataBarのように大文字・小文字が1文字だけ異なるエンコーディング列挙型は特に再確認します。 - すべてのバーコードを再読み取りできる:
GeneratedBarcode.Verifyなら1回の呼び出しで確認できます。保存したファイルをBarcodeReaderで読み取れば、ディスクに保存された画像についても確認できます。 - エラーハンドリングがある:生成されたコードは、
BarcodeReader.Readが必ずバーコードを検出すると仮定しがちです。また、LicensingException、破損したファイルに対するIronBarCodeFileException、暗号化PDFに対するIronBarCodePdfPasswordException、存在しないパスに対するSystem.IO.FileNotFoundExceptionを見落としがちです。
悪いチェックデジットは完璧にコンパイルされ、何も見つからなかった読み取りはエラーを投げる代わりに空のBarcodeResultsコレクションを返します。 後続のプロンプトでその処理を依頼し、エラーハンドリングガイドをエージェントに指摘してください。
エージェントがBarcodeScanner.DecodeImageFile()を出力した場合、それはもっともらしく見えてもIronBarcodeには存在しないメソッドです。コンパイラーが即座に検出するため、早い段階からこまめにビルドしてください。
どの実用的な制限を事前に知っておく価値がありますか?
特定のバーコードタスクは他のタスクよりもエージェントに適しています。
| タスク | 適合 | なぜ |
|---|---|---|
| バーコード生成 | 高い | 再読み取りで検証可能 |
| ラウンドトリップテスト | 高い | 文字列の一致で合否を判定 |
| サービスの接続処理 | 高い | 繰り返しのパターン |
| 実際のスキャンの調整 | 場合による | エージェントには見えない画像の不具合 |
| ライセンスとデプロイ | 低い | 利用者のキーと実行環境に依存 |
タスクがバーコードを読み取ることでチェックできる場合、エージェントはうまくそれをやり遂げます。 見えない画像に依存している場合や特定のデプロイメントターゲットに依存している場合、それはより多くのチェックが必要です。 生成、サービスの接続処理、およびラウンドトリップテストを直接Claude Codeに渡します。 ライセンス、プラットフォームパッケージ、または実際のスキャンのチューニングのために、サンプル画像またはドキュメントリンクをリクエストに添付します。
開発者が判断すべきことは?
Claude Codeはサービスとテストデータを生成し、必要に応じて修正を繰り返します。ライブラリの選択とAPI名の検証は開発者が行います。
セッション終了前に決定事項をCLAUDE.mdに記録し、次のセッションで続きから作業できるようにします。空のプロジェクトから明確な合格基準を満たすまでのタスク例は、AIコーディングアシスタントとエージェントガイドに掲載されています。ChatGPT Codex、GitHub Copilot、Cursor、Google Antigravityのガイドも用意されています。
トラブルシューティング
- エージェントの初回実行がライセンス設定の行で失敗する場合は、IronBarcodeでライセンスキーを適用するを確認してください。
- 生成したバーコードをラウンドトリップで読み取れない場合は、バーコードが認識されないを確認してください。
CLAUDE.mdにパッケージ名を記載する前に、IronBarcode NuGet パッケージを確認してください。
ご質問はありますか?
質問がある場合は、support@ironsoftware.com にお問い合わせください。
Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。