將IronBarcode工作委託給Claude Code

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

三個要點決定條碼任務是否成功: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別名,並在工作階段中切換模型。

一個套件就能涵蓋整項工作,這對代理而言比對人更重要。一維和二維條碼寫入、從單張影像讀取多個條碼,以及多執行緒讀取都由同一個API提供,因此代理不必在任務中途停下來,引入第二個程式庫並請您核准。請將往返驗證納入任務,因為GeneratedBarcode.Verify會解碼剛寫入的影像並比較數值。

所選模型等級會影響產生的程式碼與成本。同一個提示交給不同模型,會得到不同的實作,包括類別名稱、選項配置和測試結構。為確保輸出一致,請固定編碼、像素尺寸及成功讀取的標準,其餘交由模型決定。

快速開始
NuGet使用NuGet安裝

PM > Install-Package BarCode

在 NuGet 包管理器控制台中運行上述命令安裝 IronBarcode,或在 NuGet 包管理器中搜索該包。

在您的.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.
Text

Claude Code完成剩餘的步驟:它添加套件,連接非同步讀取,建置專案,解決任何編譯錯誤,並報告結果。 您檢閱程式碼更改和它測得的時間。 非同步和多執行緒指南涵蓋了它應該選擇的選項。

未指定的細節會自動決定。簡單範例使用最新套件與預設設定即可,因此可以接受。正式環境的工作則應在提示中設定以下三項限制:

  1. 指定版本:明確指定IronBarcode版本,讓代理針對同一套API撰寫程式碼。
  2. 限制依賴項:僅允許BarCode套件,因此不能引入其他條碼程式庫。
  3. 允許代理停止:指示代理僅使用文件記載的API,並在不確定時告知您。


哪部分條碼工作應該移交?

Claude Code主要處理日常開發任務。無論您使用哪種介面,它都能讀取、撰寫及重構程式碼、執行建置,並管理測試迴圈。條碼產生與掃描無需特殊設定,即可納入這個迴圈。

對於條碼任務,Claude Code負責重複性工作:撰寫標籤服務、建立掃描端點、產生所需格式的測試影像並回讀驗證。它會偵測並修正無效的EAN-13檢查碼等問題,視需要重新建置,並在發生錯誤後重試。您則提供條碼規格並檢閱產生的程式碼變更。

您仍須負責選擇條碼程式庫。若未明確指定,代理會預設採用訓練資料中最常見的程式庫,這會帶來四個問題:

  • 條碼尺寸與檢查碼:縮小的條碼、缺少的空白區或錯誤的檢查碼,可能外觀看似正確卻無法掃描;IronBarcode則會在寫入時驗證各種條碼類型的數值。
  • token用量決定費用:代理自行打造解碼器時,每項操作都會消耗token;程式庫提供的多執行緒讀取、速度預設及影像濾鏡則已完成調校,並附有文件。
  • 自訂處理流程缺乏驗證:這些流程未經大型資料集或已發布的基準測試驗證,而有完整文件的API則具備可重複執行的往返測試。
  • 套件名作為安全控制:dotnet add package IronBarcode不會安裝IronBarcode,而惡意行為者註冊了類似的名字。

在您的提示中指定BarCode,以確保代理永遠不會猜測。

指定套件後,後續任務就不必再決定使用哪個程式庫。

如何從全新安裝過渡到您的第一個條碼提示?

安裝應用程式,使用您的Claude帳戶登入,您即可開始。 Anthropic的Claude Code 概述提供了該工具的詳細說明。 快速入門指南涵蓋了macOS, Windows和Linux上的安裝和您的第一次工作階段,單獨的頁面涵蓋了VS Code和JetBrains擴充功能,適合偏好IDE的人士。Anthropic的YouTube頻道還提供了初次工作階段的影片演練。

待claude啟動且能正常回應後,再回到這裡繼續。

如何設定可供Claude Code工作的專案?

建立標準.NET專案,並在透過代理開啟前加入IronBarcode。事先確認專案能成功建置,可避免混淆,也能防止代理猜測該使用哪個條碼程式庫或名稱相似的套件。

dotnet new console -n LabelScanDemo
cd LabelScanDemo
dotnet add package BarCode --version 2026.9.2
claude
SHELL

最後一個命令會在目前資料夾開啟工作階段,將代理的讀取與編輯範圍限制在該目錄。Anthropic文件建議採用此方式:先切換至專案目錄,再啟動CLI。終端機、IDE擴充功能、桌面應用程式與網頁等介面都使用同一個引擎,因此CLAUDE.md檔案、專案設定,以及為專案設定的MCP伺服器,在各工作階段間都保持一致。

兩個額外的細節以後會有幫助:

  1. **CLAUDE.md:**Claude Code會在每次工作階段開始時載入這個指令檔,內容應指定目標框架、BarCode套件,以及僅允許使用文件記載之API的規則。
  2. IronBarcode的文件索引:llms.txt以代理可解析的格式列出真實的文件URL,而skill.md則增補了經驗證的實作範例和常見失敗的修正。

Claude Code會讀取儲存庫中.claude/skills/<name>/SKILL.md的技能。請將IronBarcode的檔案儲存為.claude/skills/ironbarcode/SKILL.md並提交。只有前置資料中的description會常駐上下文;出現相關任務時,Claude才載入正文。如此可降低條碼工作開始前的額外負擔。若要進一步限定範圍,可加入paths glob模式,例如Services/**,讓代理只在存取需要此技能的檔案時載入技能。

備妥這兩個檔案後,代理就會參考文件,不必依賴記憶。只需一個提示即可產生所需檔案。

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

請在首次執行前設定授權,因為開發寬限期結束後,IronBarcode會擲回LicensingException,而非加入浮水印。啟動時應從環境變數取得金鑰,並在任何條碼操作之前套用。IronBarcode授權金鑰文件說明了如何取得及套用金鑰。

如何提示生成可編譯的IronBarcode程式碼?

明確指定代理原本可能自行推斷的三個要素:條碼類型、數值來源,以及成功標準。

將提示寫成規範。

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

這個提示透過以下三點達成目標:

  1. 檔案路徑:提示明確指定路徑,讓您得到易於瀏覽的專案結構,而非代理自行設計的結構。
  2. 讀寫使用相同條碼類型:寫入器和讀取器都使用Code 128,讀取器就無需猜測格式。
  3. 以往返驗證定義完成:代理會驗證寫入值與回讀值是否一致,比只確認條碼外觀更可靠。
提示: 提示有效時,請指示Claude Code將其中的限制條件複製到CLAUDE.md,讓後續工作階段自動載入這些限制。

結果應該很簡短:使用BarcodeWriter.CreateBarcode搭配BarcodeEncoding.Code128,再透過ResizeTo、AddBarcodeValueTextBelowBarcode和SetMargins調整標籤尺寸、印出數值並加入空白區。ToPngBinaryData產生位元組資料,BarcodeReader.ReadAsync則在ExpectBarcodeTypes設為Code 128的情況下讀取。處理實際掃描影像時,Speed、CropArea及影像濾鏡等選項比處理產生的檔案更重要。條碼讀取器教學課程說明了這些選項。

請注意: 始終要求程式碼附帶文件連結。 如果代理無法為其使用的API提供有效的參考,您會在編譯失敗之前知道。

Claude Code可以通過MCP連接到IronBarcode嗎?

Claude Code透過開放標準模型上下文協定(MCP)整合外部工具。MCP伺服器可提供模型在訓練時未見過的工具、資料庫與API;只需一個CLI命令即可新增伺服器,詳見MCP參考。

IronBarcode不需要伺服器,其整合方式是透過三個URL發布的文件。llms.txt提供文件索引,skill.md包含已驗證的實作範例及常見故障,API參考則列出該版本的所有類別與成員。閱讀這些文件能讓代理取得最新資訊,解決MCP伺服器也常處理的API方法資訊過時問題。無需執行額外程序或維護設定,文件更新時也無需重新啟動;代理只要在工作階段中擷取這些頁面即可。

請將這三個來源貼入專案上下文,或從CLAUDE.md引用它們,讓工作階段中的每個提示都能使用。

在信任生成的條碼程式碼之前您應該驗證哪些內容?

驗證每個API名稱和每個條碼,每次都要如此。按照順序遵循這四個步驟,因為每一個都比下一個成本更低:

  • 建置通過:在檢閱任何差異之前,先執行dotnet build,因為虛構的成員會在幾秒內造成建置失敗。
  • 確認每個成員都存在:在API 參考中搜尋所有不熟悉的類別與方法,尤其要再次核對Databar與DataBar僅一個字母大小寫不同的編碼列舉。
  • 每個條碼回讀:GeneratedBarcode.Verify一次呼叫即可確認這一點,而用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的相關指南。


疑難排解

問題?

如果您有任何疑問,請聯繫support@ironsoftware.com

Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

閱讀更多

準備好開始了嗎?

NuGet 下載次數 2,564,559版本:2026.11剛剛發布