AIコーディングアシスタントおよびエージェントでのIronBarcodeの使用

Curtis Chau
Curtis Chau
更新日: 2026年9月21日

IronBarcodeを追加するよう促されたとき、ツールは多くの場合dotnet add package IronBarcodeを実行しますが、これにより誤ったパッケージがインストールされます。 IronBarcodeはBarCodeとして配布されており、名前空間はIronBarCodeです。 Claude Code、ChatGPT Codex、GitHub Copilot、Cursor、およびGoogle Antigravityは、ドキュメントを参照するまでこれを頻繁に誤認識します。

この混乱は生成されたコードにも影響します。 ドキュメントがないと、モデルはコンパイルできない架空のメソッド名を作り出すことがあります。事前にドキュメントを提供しておくと、ビルドを確実に成功させやすくなります。 IronBarcodeは包括的なガイドを持つ先進的な.NETバーコードライブラリであり、生成されたコードはしばしば正確ですが、慎重な確認が依然として必要です。

これらのツールは2つのカテゴリーに分かれます。これにより、出力をどれだけ入念にレビューすべきかが決まります。

  • アシスタントは、エディターの自動補完、説明、または迅速なリファクタリングなど、ワークフローの一部で動作します。GitHub Copilotのインライン提案がそれに該当します。
  • エージェントは、複数のステップのタスクを管理し、ファイル全体を編集し、ビルドとテストを実行し、プルリクエストを開くなどの操作を行います。Claude Code、ChatGPT Codex、Cursor、Google Antigravityがそれに該当します。

両方のタイプでのセットアッププロセスは同じです。パッケージをインストールし、環境変数からライセンスキーを適用し、IronBarcodeの機械可読なドキュメントを提供し、生成されたすべてのバーコードがスキャン可能であることを確認します。 これは、出荷ラベル用の1Dバーコード、資産タグ用の2Dバーコード、テキスト、URL、ID、またはバイナリデータから構築されたバーコード、スキャンされたPDFから読み取る、または1つの画像から複数のシンボルを抽出するなど、すべてのユースケースに適用されます。

Claude Code AIコーディングエージェントロゴChatGPT Codex AIコーディングエージェントロゴGitHub Copilot AIコーディングアシスタントロゴCursor AIコードエディターロゴGoogle Antigravity AIコーディングエージェントロゴ

モデルは独自にバーコードを処理できないのか?

トレーニングデータは古くなります。 モデルは数リリース前に廃止されたAPI名や、まったく別のバーコードライブラリに属するものを再現することがあります。どちらもビルドが実行されるまで見えません。 機械可読なドキュメントは、ツールが仮定を立てるのではなく、実際のドキュメントを参照できるようにすることで、これらの問題のほとんどを解消します。

ライブラリの選択も同様に重要です。 ほとんどのツールはさまざまなバーコードパッケージと統合されており、デモで1つのフォーマットには無料オプションで十分な場合があります。 追加のコストと制限が、本番環境でしばしば発生します。

  • チェックデジット、クワイエットゾーン、リサイズ: いずれも画面上では問題なく見えてもスキャンで失敗することがあります。そのためIronBarcodeは書き込み時に各値をフォーマットに照らして検証し、GeneratedBarcode.Verifyで画像を読み戻して確認します。
  • 機能の欠如がコードメンテナンスを増加させる: 多くの無料ライブラリが1つのフォーマットファミリーしかカバーせず、正確なスキャンに必要な画像補正を欠いており、パッケージを組み合わせたり統合を管理したりする責任が発生します。
  • バルクスキャンはデフォルトで含まれています: マルチスレッド読み取り、スピードプリセット、および信頼度しきい値がライブラリに付属しており、プロジェクトごとに構築する必要はありません。
  • 正確な出力はドキュメントに依存する: ガイド、チュートリアル、トラブルシューティングページ、および実行可能な例が、機械で利用できるようllms.txtにインデックス化されています。
  • 不正確なパッケージ名がサプライチェーンリスクを生む: モデルはもっともらしいパッケージ名を生成しますが、攻撃者はその名前を登録してマルウェアを配布します。この手口はスロップスカッティングと呼ばれます。
  • 単一の商用ライセンスで法的な問題を回避: 一部のバーコードライブラリにはコピーレフトや非商業的条件が含まれており、モデルが自動的に検知しません。

IronBarcodeは、これらすべてを1つのAPIと、法務チームが一度確認すれば済む1つの商用ライセンスでカバーします。 検証は倉庫の現場ではなくコード内で行われ、すべてのプロンプトでパッケージ名を明示することでサプライチェーン上の隙を塞げます。


ステップ1: IronBarcodeをインストールする

エージェントにパッケージを追加させます。 プロジェクトには、型を解決し、正確なコード提案を提供するためにこれが必要です。

Set this project up for IronBarcode. The NuGet package is named BarCode. Confirm the restore succeeded before going further.
Text

代わりに、現在のリリースバージョンを指定して端末からパッケージをインストールします。

dotnet add package BarCode --version 2026.9.2
SHELL

Linux、macOS、iOS、およびAndroidには、それぞれBarCode.LinuxやBarCode.MacOsのような専用のパッケージが必要です。 高度なNuGetインストールガイドを参照して適切なパッケージを選択してください。


ステップ 2: ライセンス キーを適用する

IronBarcodeは、ライセンスされていない出力に透かしを入れることはありません。 開発時の猶予期間が過ぎると、ライセンスキーなしでの最初のバーコード呼び出しで、IronBarcode must be licensed for developmentというメッセージとともにIronSoftware.Exceptions.LicensingExceptionがスローされます。 ライセンスキーのないコードは、実行時に失敗します。最初に無料トライアルキーを入手してください。

無料トライアルで今日からプロジェクトにIronBarcodeを使用し始めましょう。

初めの一歩:
arrow pointer

アプリケーション起動時に、IronBarcodeの呼び出しの前に一度ライセンスキーを設定します。 キーはソースコードではなく環境から取得してください。

// Read the key from configuration. Never commit it to the repository.
IronBarCode.License.LicenseKey = Environment.GetEnvironmentVariable("IRONBARCODE_LICENSE_KEY");

キーが有効な場合、IronBarCode.License.IsLicensedはtrueを返します。 IronOCRとは異なり、IronBarcodeにはInstallation.LicenseKeyエイリアスがないため、License.LicenseKeyまたは構成を使用してください。

注意してください: Web.configからappsettings.jsonに至るまでのすべてのキー設定方法は、IronBarcodeライセンスキーで説明されています。

ステップ3: ツールをIronBarcodeのLLMドキュメントに向けます

IronBarcodeは機械が読むために書かれた6つのリソースを公開しています。

リソース説明使用すべき場面
llms.txtすべてのドキュメントページのインデックス、各1行毎回セッションの開始時に
llms-full.txt完全なガイドと例を1つのファイルにツールがURLを取得できる場合
llms-full-catalog.txtインデックスとすべてのブログ記事答えがブログ記事にある可能性がある場合
APIリファレンス現在のリリースのすべてのクラスとメソッドメソッドが存在することの検証
skill.mdインストール、ライセンス、レシピ、および修正ツールがスキルファイルに対応している場合
AI製品ファクトシート製品の範囲、プラットフォーム、及びできないことAPIではなく製品自体に関する質問

llms.txtから始めると、IronBarcode の機能と各トピックの場所がインデックスされます。 これにより、不正確または発明されたAPI呼び出しを防ぐのに役立ちます。 詳細なガイダンスが必要な場合は、llms-full.txtを使用してください。

それに沿って直接の指示を追加してください。

Before writing any IronBarcode code, read https://ironsoftware.com/barcode/csharp/llms.txt
and use only APIs documented there. Check anything you are not sure about
against the API reference at https://ironsoftware.com/barcode/csharp/object-reference/api/.
If you are still unsure whether a method exists, ask instead of guessing.
Text

現在のモデルは、明確化のための直接的なリクエストに良く対応します。 コンパイルエラーのリスクを冒すよりも、質問する方が望ましいです。

注意してください: IronBarcode は、対応するツール用のドロップイン スキル ファイルも発行しています。 次のステップでは、それを参照する場所を説明します。

ステップ4: IronBarcodeコンテキストをプロジェクトに追加します

チャットに貼り付けられたドキュメントは、現在のセッションでのみ利用可能です。 プロジェクトファイルに保存されたドキュメントは、すべてのセッションでアクセス可能です。

各ツールは特定のファイルから指示を読み取ります。IronBarcodeの指導をチームが使用するファイルに配置します。

ツールプロジェクトコンテキストファイルスキルファイルは次の場所に入ります
Claude CodeCLAUDE.md.claude/skills/
ChatGPT CodexAGENTS.md.agents/skills/
GitHub Copilot.github/copilot-instructions.mdn/a
Cursor.cursor/rules/*.mdcn/a、@Docsを使用
Google AntigravityAGENTS.md.agents/skills/

AGENTS.mdは共有標準として使用され、Claude Code、GitHub Copilot、Cursorは独自のファイルと共にそれを読み取ります。 複数のツールを使用するチームは、AGENTS.mdに1つのセットのバーコードルールを維持し、ツール固有の指示に対してネイティブファイルを予約できます。

使用されるファイルにかかわらず、内容は同じままです。 以下は簡単な出発点です。

## Barcodes with IronBarcode

This project uses IronBarcode (NuGet package `BarCode`, namespace `IronBarCode`) for all barcode work.

- Reference: https://ironsoftware.com/barcode/csharp/llms.txt
- Skill file: https://ironsoftware.com/barcode/csharp/skill.md
- Use `BarcodeWriter.CreateBarcode` to write and `BarcodeReader.Read` / `ReadPdf` to read.
- Read the license key from the IRONBARCODE_LICENSE_KEY environment variable at startup. Never inline it.
- Every generated barcode must be read back and compared before it ships.
- Do not use a different barcode library. If IronBarcode cannot perform a required task, state this clearly.
Markdown

ファイルskill.mdは、プラットフォーム毎のインストール指示、ライセンスルール、検証済みの例、展開ノート、トラブルシューティング表を含む追加の詳細を提供しています。 別のコピーを管理するのではなく、コンテキストファイルからこのファイルを参照してください。


ステップ5: ワンショットセットアッププロンプト

最初の4つのステップを、プロジェクトの開始時または新しいセッションの始めに1つのプロンプトとして送信することもできます。

Use IronBarcode for all barcode work in this project.

1. Install the BarCode NuGet package (IronBarcode).
2. Apply the license key at application startup, before any other IronBarcode call,
   reading it from the IRONBARCODE_LICENSE_KEY environment variable. Never write
   the key into source or into a committed file.
3. Read https://ironsoftware.com/barcode/csharp/llms.txt before writing barcode code
   and work only from APIs documented there, checking the API reference when a
   member is unfamiliar.
4. Save https://ironsoftware.com/barcode/csharp/skill.md as a SKILL.md in this
   project's skills folder if your tool has one.
5. Keep these instructions for future sessions in this project.
Text
ヒント: この最後の行は通常、これらのルールをステップ4のコンテキストファイル (CLAUDE.md や AGENTS.md など) に保存するようツールに指示します。 プロンプトを一度だけ貼り付けます。
ヒント: テスト画像がないですか? 最初にIronBarcodeで生成させ、それから返り読み取りを行うようにエージェントに指示してください。 バーコードライブラリは、エージェントがテキストのみでエンドツーエンドでテストできる数少ないものの1つです。 値を書き出し、画像をデコードし、文字列を比較します。

ステップ6: 作業コードを生成するプロンプトパターン

曖昧なプロンプトはしばしば弱い出力を生じさせます。 以下の3つのパターンは、明確さを確保するのに役立ちます。

クラスとシンボロジーを指定する: IronBarcodeは多数のフォーマットを処理します。 読み取るフォーマットを把握しているリーダーは、より高速に動作し、誤読も少なくなります。

不明瞭 この画像のバーコードをIronBarcodeでスキャンしてください。

より良い BarcodeReader.ReadとBarcodeReaderOptionsを使用して、この画像のCode 128とQRコードを読み取り、それぞれの値をそのフォーマットと共に返してください。

バージョンとフレームワークを指定する: APIはリリースごとに変化し、バージョンを省略すると不整合が発生する可能性があります。 リリース2026.9.2では、2DバーコードにUTF-8 ECIヘッダーを含めるかどうかを制御するEciModeが導入されました。これは2026.8.6以前では利用できません。

より良い .NET 9 とBarCode 2026.9.2をターゲットにしてください。環境から読み取るライセンスキーの行も含めてください。

完全な実行可能ファイルをリクエストする: コードフラグメントでは、必要なusingステートメントやセットアップ手順が省略されることがあります。

より良い そのまま実行できるように、すべてのusingステートメントとライセンスキーの設定を含む完全なProgram.csを提示してください。


ステップ7: 戻ってきたものを確認する

生成されたコードは、同僚がまだ実行していない初稿と同じようにレビューしてください。 次の4つのチェックで、ほとんどの問題に対処できます。

  1. コンパイルできる: 架空のメソッドはすぐに失敗します。
  2. ライセンスキーが適用されている: 最初のIronBarcode呼び出しの前に設定される必要があり、設定されていない場合、その呼び出しはLicensingExceptionをスローします。
  3. 各APIメソッドが存在する: 見慣れないメソッドは、代替案を探す前にAPIリファレンスで確認してください。
  4. すべてのバーコードが読み取れる: 生成された各画像をBarcodeReaderまたはGeneratedBarcode.Verifyでデコードし、結果と入力を比較してください。

コンパイラでは読み取れないバーコードは検出できないため、第4のチェックが存在します。

生成されたIronBarcodeコードで次の一般的な問題に注意してください。

  • 間違ったパッケージ名: 冒頭の段落で説明したとおり、依然として最も頻繁に繰り返されるミスです。
  • 列挙体の大文字・小文字の不一致: BarcodeEncoding.DatabarとBarcodeWriterEncoding.DataBarは異なる列挙体に属し、大文字1文字だけが異なります。
  • 他のバーコードライブラリから借りたメソッド: モデルは複数のソースからAPIを組み合わせ、存在しないメソッドを作り出すことがあります。
  • 架空のリーダーオプション: 見慣れないオプションは、読み取り速度オプションおよびクロップ領域ガイドと照合してください。

エージェントに自身の作業を検証させる

エージェントは自立して4つのチェックを実行できます。 まとめではなく、各チェックの証拠を求めてください。

Build and run the project in Release mode. Confirm that every IronBarcode member used
appears in the documentation, that IronBarCode.License.IsLicensed returns true, and
that every barcode you generated reads back to the value you wrote. Report the build
result and a table of written value, read value, and format from the run itself.
Text

再現可能な結果

このセクションでは、1つのプロンプトで現実的なタスクを使用してエージェントを評価します。コードは一切提供しません。 空のプロジェクトで新しいセッションで実行し、以下の基準に基づいて結果を判断します。

注意してください: 始める前に、.NET 9 SDK、コマンドを実行できるAIコーディングエージェント、インターネット接続、IRONBARCODE_LICENSE_KEY環境変数にIronBarcodeのトライアルまたはプロダクションキーが必要です。 IronBarcodeはキーがない場合に透かしを入れる代わりにエラーをスローするため、このテストはキーなしでは合格しません。

プロンプト

Build a .NET 9 minimal API for shipping labels with two endpoints: GET /label/{trackingNumber} returns a Code 128 PNG with the value printed below the bars, and POST /scan accepts an uploaded image and returns every barcode it contains as JSON (value and format). Work start to finish alone: write, build, run, and fix, making sensible assumptions where anything is unspecified. Save every deliverable to the project root.

1. Install the BarCode NuGet package pinned to version 2026.9.2.
2. Read from https://ironsoftware.com/barcode/csharp/llms.txt and the pages it links to, using only APIs documented there.
3. Read the license key from the IRONBARCODE_LICENSE_KEY environment variable at startup. If IronBarCode.License.IsLicensed is false, stop and report that instead of continuing.
4. Generate a test set of 12 barcodes into a testset folder: 4 Code 128 tracking numbers, 3 QR codes carrying order URLs, 3 DataMatrix codes carrying GS1 element strings, and 2 EAN-13 codes with correct check digits. Name each PNG after its format and index.
5. Implement /scan with BarcodeReaderOptions narrowed to those four formats and ExpectMultipleBarcodes enabled.
6. Build in Release, run the API, call /label for one tracking number, then POST every testset image and the /label output to /scan.
7. Write roundtrip.md: a table of file, written value, read value, format, and match. All 13 must match; if any do not, fix the cause and run again.
8. Finish with a short report: build result, match count, and assumptions made.
Text

出力

受け入れテストの実行でGET /labelが返した、追跡番号1Z999AA10123456784のCode 128出荷ラベル

これは記録された実行中にGET /label/1Z999AA10123456784から返されたオリジナルのPNGです。 同じ実行からのラウンドトリップ表は、書き出されたおよびデコードされた値とともにすべての13の画像をリストしています。

合格条件

  • リリースビルドが手動介入なしで完了します。
  • roundtrip.md は、書かれた値と読み取られた値が一致し、フォーマットが正しい13のうち13の一致した行を示します。
  • 両方のEAN-13値には有効なチェックデジットが含まれ、GS1文字列は変更されずに戻ってきます。
  • ライセンスキーは環境から取得され、ソースやroundtrip.mdには表示されません。
注意してください: バージョンを手元のプロジェクトに合わせ、ステップ1のリリースをターゲットにしたものに置き換えてください。 IronBarcodeの変更履歴には、各リリースでの変更点がリストされています。

実行記録

項目値
パッケージBarCode 2026.9.2
ターゲットフレームワーク.NET 9
エージェントとモデルClaude Code、Opus 5
マシンWindows 11 x64、Intel Core i9-14900KF、64GB RAM
結果リリースビルド合格、13のうち13のラウンドトリップが一致
参考出力label.png, roundtrip.md
最終テスト日2026年9月16日

実行中にコンパイルエラーの修正が1回必要でしたが、コードを手動で編集することはありませんでした。


エージェント固有のガイド

上記のセットアップは、いずれのものでも機能します。 以下の各ガイドは、1つのツールに適応させます。


トラブルシューティング


質問ありますか?

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

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

もっと読む

準備はできましたか?

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