Delegowanie pracy z IronBarcode narzędziu Claude Code

Curtis Chau
Curtis Chau
Zaktualizowano: 21 września 2026

Trzy fakty decydują o sukcesie zadania z kodem kreskowym. Pakiet NuGet to BarCode, klucz licencyjny pochodzi ze środowiska, a praca jest niedokończona, dopóki obraz nie zostanie zdekodowany, a odczytana wartość porównana z zapisaną. Claude Code jest narzędziem w tej serii, które przechowuje te fakty w repozytorium, a nie w prompcie. Czyta CLAUDE.md na początku każdej rozmowy i ładuje .claude/skills/ironbarcode/SKILL.md, gdy zadanie dotyczy kodu kreskowego, do czego służy opublikowany skill.md IronBarcode.

Te zasady obowiązują bez względu na model, który je czyta, a wybór modelu jest głównym sposobem kontrolowania kosztów. Opcja /model sonnet jest wystarczająca dla większości zadań z kodami kreskowymi, takich jak połączenie usługi etykietowania i uruchamianie zestawów testowych. Opcja /model opusplan wykorzystuje Opus do planowania i Sonnet do implementacji, co jest korzystne w przypadku skomplikowanych migracji, gdzie mapowanie kodu jest istotne. Alias fable, który wskazuje na Fable 5.1, oraz alias haiku dla prostych zadań są również dostępne i można przełączać modele w trakcie sesji.

Jeden pakiet obsługuje całe zadanie, co ma większe znaczenie przy agencie niż przy człowieku. Generowanie kodów 1D i 2D, odczyt wielu kodów kreskowych z jednego obrazu, oraz wielowątkowe odczyty pochodzą z tego samego API, więc agent nigdy nie przerywa zadania, aby dodać drugą bibliotekę do zatwierdzenia. Uwzględnić cykl zapisu i ponownego odczytu w samym zadaniu, ponieważ GeneratedBarcode.Verify dekoduje właśnie zapisany obraz i porównuje wartość.

Wybrany poziom modelu wpływa zarówno na generowany kod, jak i koszty. Dostarczenie tego samego promptu różnym modelom daje różne implementacje, w tym nazwy klas, układy opcji i struktury testowe. Aby uzyskać spójne wyniki, należy ustalić kodowanie, wymiary obrazu w pikselach i kryteria pomyślnego odczytu, a pozostałe decyzje pozostawić modelowi.

Szybki start
NuGetInstalacja z NuGet

PM > Install-Package BarCode

Zainstaluj IronBarcode, wykonując powyższe polecenie w konsoli Menedżera Pakietów NuGet lub wyszukaj pakiet w Menedżerze Pakietów NuGet.

Rozpocząć sesję w projekcie .NET i skoncentrować się na wymaganiach, a nie na szczegółach implementacji, wybierając pożądany kod kreskowy.

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 wykonuje kolejne kroki: dodaje pakiet, podłącza asynchroniczny odczyt, buduje projekt, rozwiązuje błędy kompilacji i raportuje wyniki. Przeglądać zmiany w kodzie i mierzony czas. Przewodnik asynchroniczny i wielowątkowy obejmuje opcje, do których należy sięgać.

Wszelkie nieokreślone szczegóły są ustalane automatycznie. W przypadku prostych przykładów jest to dopuszczalne, ponieważ używane są najnowszy pakiet i domyślne ustawienia. W przypadku pracy produkcyjnej należy określić w prompcie trzy następujące ograniczenia:

  1. Określić wersję: wskazać wydanie IronBarcode, aby agent działał z jednym ustalonym zestawem elementów API.
  2. Ograniczyć zależności: zezwolić tylko na pakiet BarCode, aby nie wprowadzać dodatkowej biblioteki kodów kreskowych.
  3. Zezwolić na zatrzymanie agenta: poinstruować go, aby używał tylko udokumentowanych API i informował, gdy jest niepewny.


Które części pracy z kodami kreskowymi należy przekazać?

Claude Code głównie zajmuje się rutynowymi zadaniami deweloperskimi. Czyta, pisze i refaktoryzuje kod, uruchamia kompilacje i zarządza pętlą testową z dowolnego używanego interfejsu. Generowanie i skanowanie kodów kreskowych wpisuje się w tę pętlę bez specjalnej konfiguracji.

W przypadku zadań z kodami kreskowymi Claude Code zarządza pracą powtarzalną: pisze usługi etykietowania, tworzy punkty końcowe skanowania, generuje testowe obrazy w wymaganych formatach i odczytuje je z powrotem. Wykrywa i koryguje problemy, takie jak niepoprawna cyfra kontrolna EAN-13, ponownie kompiluje projekt w razie potrzeby i próbuje ponownie po błędach. Do użytkownika należy podanie specyfikacji kodu kreskowego i przegląd wynikowych zmian w kodzie.

Użytkownik nadal odpowiada za wybór biblioteki kodów kreskowych. Jeśli nie określi się żadnej, agent domyślnie wybiera to, co najczęściej widział podczas trenowania, co prowadzi do czterech problemów:

  • Rozmiar symbolu i cyfry kontrolne: pomniejszony symbol, brak strefy ciszy lub błędna cyfra mogą wydawać się poprawne i mimo to zawodzić podczas skanowania; IronBarcode natomiast weryfikuje wartości dla każdej symboliki podczas zapisu.
  • Liczba tokenów decyduje o kosztach: agent, który buduje swój własny dekoder, płaci tokenami za każdą operację, podczas gdy wielowątkowe odczyty, ustawienia prędkości i filtry obrazu są już dostrojone i udokumentowane.
  • Brak walidacji w niestandardowych potokach: nie są testowane na dużych zbiorach danych ani opublikowanych benchmarkach, w przeciwieństwie do udokumentowanego API z powtarzalnym testem zapisu i ponownego odczytu.
  • Nazwa pakietu działa jako kontrola bezpieczeństwa: dotnet add package IronBarcode nie instaluje IronBarcode, a podobne nazwy zostały zarejestrowane przez złośliwe podmioty.

Określić BarCode w prompcie, aby agent nigdy nie musiał zgadywać.

Po wskazaniu pakietu kolejne zadania nie wymagają decyzji dotyczącej biblioteki.

Jakie kroki prowadzą od świeżej instalacji do pierwszego promptu z kodem kreskowym?

Zainstalować aplikację, zalogować się na konto Claude i rozpocząć pracę. Przegląd Claude Code autorstwa Anthropic zapewnia szczegółowe wyjaśnienie narzędzia. Szybki start obejmuje instalację i pierwszą sesję na macOS, Windows i Linux, a oddzielne strony obejmują rozszerzenia VS Code i JetBrains dla tych, którzy preferują IDE. Kanał YouTube Anthropic oferuje także wideo-przewodniki po pierwszej sesji.

Wrócić, gdy claude zostało uruchomione i odpowiada.

Jak skonfigurować projekt, w którym Claude Code może pracować?

Utworzyć standardowy projekt .NET i dodać IronBarcode przed jego otwarciem za pomocą agenta. Zapewnienie, że projekt buduje się pomyślnie z wyprzedzeniem, eliminuje zamieszanie i zapobiega zgadywaniu przez agenta, której biblioteki kodów kreskowych lub którego z podobnie nazwanych pakietów użyć.

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

Ostateczne polecenie otwiera sesję w bieżącym folderze, ograniczając odczyty i edycje agenta do tego katalogu. Dokumentacja Anthropic zaleca takie podejście. Przejść do katalogu projektu przed uruchomieniem CLI. Wszystkie interfejsy, w tym terminal, rozszerzenia IDE, aplikacja desktopowa i web, korzystają z tego samego silnika. W rezultacie plik CLAUDE.md, ustawienia projektu i serwery MCP skonfigurowane dla projektu pozostają spójne między sesjami.

Dwa dodatkowe szczegóły będą korzystne później:

  1. CLAUDE.md: plik instrukcji, który Claude Code ładuje na początku każdej sesji, określający docelowy framework, pakiet BarCode, i regułę, że dozwolone są tylko udokumentowane API.
  2. Indeks dokumentacji IronBarcode: llms.txt zawiera prawdziwe URL-e dokumentacji w formacie, który agenci mogą analizować, a skill.md dodaje zweryfikowane rozwiązania i poprawki dla typowych błędów.

Claude Code odczytuje umiejętności z .claude/skills/<name>/SKILL.md w repozytorium. Należy zapisać plik IronBarcode jako .claude/skills/ironbarcode/SKILL.md i zatwierdzić go w repozytorium. Tylko pole nagłówka frontmatter description pozostaje w kontekście, a Claude ładuje treść, gdy pojawia się odpowiednie zadanie. To podejście minimalizuje narzut aż do momentu rozpoczęcia pracy z kodem kreskowym. Aby jeszcze bardziej zoptymalizować, należy dodać glob paths taki jak Services/**, aby ładować umiejętność tylko wtedy, gdy agent uzyskuje dostęp do potrzebujących jej plików.

Gdy oba pliki są na swoim miejscu, agent będzie odnosił się do dokumentacji zamiast polegać na pamięci. Pojedynczy prompt może wygenerować wymagany plik.

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

Skonfigurować licencjonowanie przed pierwszym uruchomieniem, ponieważ IronBarcode rzuca LicensingException zamiast dodawać znak wodny po zakończeniu okresu karencji dla deweloperów. Pobrać klucz ze środowiska podczas uruchamiania aplikacji, przed jakąkolwiek operacją na kodzie kreskowym. Dokumentacja kluczy licencyjnych IronBarcode wyjaśnia, jak uzyskać i zastosować klucz.

Jak poprosić o kod IronBarcode, który się kompiluje?

Określić trzy elementy, które agent mógłby w przeciwnym razie wywnioskować: symbolikę, źródło wartości i kryteria sukcesu.

Pisać prompty jako specyfikacje.

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

O skuteczności tego promptu decydują trzy elementy:

  1. Ścieżki plików: prompt nazywa je, dając przejrzystą strukturę projektu zamiast tej, którą wymyśla agent.
  2. Symbolika po obu stronach: generator i czytnik używają Code 128, co eliminuje potrzebę zgadywania formatu przez czytnik.
  3. Ukończenie zdefiniowane jako zapis i ponowny odczyt: agent weryfikuje, że zapisana wartość odpowiada odczytanej wartości, co jest lepsze niż potwierdzanie wyglądu kodu kreskowego.
Porady: Gdy prompt jest skuteczny, należy polecić Claude Code skopiowanie jego ograniczeń do CLAUDE.md. Przyszłe sesje będą automatycznie ładować te ograniczenia.

Wynik powinien być krótki. Używa BarcodeWriter.CreateBarcode z BarcodeEncoding.Code128, potem ResizeTo, AddBarcodeValueTextBelowBarcode i SetMargins do ustalenia rozmiaru etykiety, wydrukowania jej wartości i dodania strefy ciszy. ToPngBinaryData produkuje bajty, a BarcodeReader.ReadAsync je odczytuje z ExpectBarcodeTypes ustawionym na Code 128. Dla rzeczywistych skanów zamiast generowanych plików opcje takie jak Speed, CropArea i filtry obrazu stają się znacznie ważniejsze. Samouczek czytnika kodów kreskowych obejmuje je.

Uwaga: Zawsze należy żądać linku do dokumentacji z kodem. Jeśli agent nie może dostarczyć prawidłowego odniesienia do używanego API, będzie to wiadomo przed niepowodzeniem kompilacji.

Czy Claude Code może połączyć się z IronBarcode przez MCP?

Claude Code integruje się z narzędziami zewnętrznymi poprzez Model Context Protocol (MCP), otwarty standard. Serwer MCP może udostępniać narzędzia, bazy danych i API, których model nigdy nie widział podczas trenowania, a jedno polecenie CLI dodaje serwer, jak pokazuje dokumentacja MCP.

IronBarcode nie potrzebuje serwera. Jego integracja to dokumentacja, opublikowana jako trzy URL-e. llms.txt indeksuje dokumentację. Plik skill.md zawiera zweryfikowane rozwiązania i typowe błędy. Dokumentacja API zawiera każdą klasę i każdy element API w wydaniu. Czytanie ich daje agentowi aktualne fakty, a nie zapamiętane API, co jest tym samym problemem z przestarzałymi metodami, który często rozwiązują serwery MCP. Nie ma procesu do uruchomienia, ani konfiguracji do utrzymania, ani restartu podczas aktualizacji dokumentacji. Agent po prostu pobiera strony podczas sesji.

Dodać te trzy źródła do kontekstu projektu, albo wklejając je, albo odwołując się do nich z CLAUDE.md. Każdy prompt w sesji może wtedy z nich korzystać.

Co należy sprawdzić przed zaufaniem wygenerowanemu kodowi obsługi kodów kreskowych?

Zweryfikować każdą nazwę API i każdy kod kreskowy, za każdym razem. Przestrzegać tych czterech kroków po kolei, ponieważ każdy z nich jest mniej kosztowny niż następny:

  • Kompilacja kończy się powodzeniem: uruchomić dotnet build przed przeczytaniem choćby jednej linii zmian, ponieważ nieistniejący element API powoduje błąd w kilka sekund.
  • Każdy element API istnieje: wyszukać w dokumentacji API każdą klasę i metodę, której nie można rozpoznać, przyjrzeć się ponownie enumom kodowania, gdzie Databar i DataBar różnią się wielkością jednej litery.
  • Każdy kod kreskowy można ponownie odczytać: GeneratedBarcode.Verify to rozstrzyga jednym wywołaniem, a odczytywanie zapisanego pliku za pomocą BarcodeReader potwierdza to samo o tym, co dotarło do dysku.
  • Obsługa błędów jest na miejscu: wygenerowany kod zazwyczaj przyjmuje, że BarcodeReader.Read zawsze znajduje kod kreskowy i pomija LicensingException, IronBarCodeFileException dla uszkodzonego pliku, IronBarCodePdfPasswordException dla zaszyfrowanego PDF i zwykły System.IO.FileNotFoundException zgłaszany przy brakującej ścieżce.

Zła cyfra kontrolna kompiluje się doskonale, a odczyt, który niczego nie znajduje, zwraca pustą kolekcję BarcodeResults zamiast rzucać wyjątek. Poprosić o taką obsługę w kolejnym prompcie i wskazać agentowi przewodnik obsługi błędów.

Agent, który zapisuje BarcodeScanner.DecodeImageFile(), wygenerował prawdopodobną nazwę metody, której IronBarcode nie posiada. Kompilator ją odrzuca natychmiast, więc należy kompilować projekt od początku i często.

Jakie są praktyczne ograniczenia, które warto znać wcześniej?

Niektóre zadania z kodem kreskowym lepiej nadają się dla agenta niż inne.

ZadaniePrzydatnośćDlaczego
Generowanie kodów kreskowychWysokaZweryfikowane przez odczytanie
Testy zapisu i odczytuWysokaWynik pozytywny oznacza zgodność ciągów
Podłączenie usługiWysokaPowtarzający się wzorzec
Dostrajanie rzeczywistych skanówZróżnicowanaWady, których nie widzi
Licencjonowanie i wdrażanieNiskaKlucz, platforma

Jeśli zadanie można sprawdzić przez odczyt kodu kreskowego, agent dobrze sobie z nim radzi. Jeśli zależy od niewidocznych obrazów lub konkretnego celu wdrożeniowego, potrzebuje więcej sprawdzania. Bezpośrednio powierzyć Claude Code generowanie kodów, integrację usług i testy zapisu i odczytu. Dla licencjonowania, pakietów platformowych, lub dostrajania rzeczywistych skanów, dołączyć przykładowe obrazy lub link do dokumentacji do żądania.

Które decyzje pozostają do podjęcia?

Claude Code generuje usługi i dane testowe i iteruje w miarę potrzeby. Wybór biblioteki i weryfikacja nazw API pozostają odpowiedzialnością użytkownika.

Dokumentować decyzje podjęte podczas sesji w CLAUDE.md przed jej zamknięciem, aby następna sesja zaczynała tam, gdzie ta się skończyła. Zadanie zrealizowane od pustego projektu do spełnienia określonych kryteriów akceptacji jest opisane w przewodniku po asystentach i agentach kodowania AI, obok ChatGPT Codex, GitHub Copilot, Cursor, i przewodników Google Antigravity.


Rozwiązywanie problemów

Pytania?

W przypadku jakichkolwiek pytań, należy skontaktować się z support@ironsoftware.com

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

Czytaj więcej

Gotowy, aby rozpocząć?

Pobrania z NuGet 2,564,559Wersja:2026.11właśnie wydane