IronBarcode-Aufgaben an Claude Code delegieren

Curtis Chau
Curtis Chau
Aktualisiert: 21. September 2026

Drei Fakten entscheiden, ob eine Barcode-Aufgabe erfolgreich ist. Das NuGet-Paket ist BarCode, der Lizenzschlüssel stammt aus der Umgebung, und die Arbeit ist unvollständig, bis das Bild dekodiert und der dekodierte Wert mit dem geschriebenen Wert verglichen wurde. Claude Code ist das Werkzeug in dieser Serie, das diese Fakten im Repository behält, statt in Ihrem Prompt. Es liest CLAUDE.md zu Beginn jeder Konversation und lädt .claude/skills/ironbarcode/SKILL.md, sobald eine Aufgabe Barcode-Code betrifft. Genau für diesen Zweck ist die von IronBarcode veröffentlichte Datei skill.md vorgesehen.

Diese Regeln gelten für jedes Modell, das sie liest, und das Modell, das Sie auswählen, ist Ihr Haupthebel für die Kosten. Die Option /model sonnet ist ausreichend für die meisten Barcode-Aufgaben, wie das Einbinden eines Etikettendienstes und das Ausführen von Testsätzen. Die Option /model opusplan verwendet Opus für die Planung und Sonnet für die Implementierung, was vorteilhaft für komplexe Migrationen ist, bei denen die Codezuordnung entscheidend ist. Der Alias fable, der Fable 5.1 auswählt, und der Alias haiku für einfache Aufgaben sind ebenfalls verfügbar, und Sie können während einer Sitzung zwischen Modellen wechseln.

Ein Paket deckt die gesamte Arbeit ab, was bei einem Agenten mehr zählt als bei einer Person. 1D- und 2D-Schreiben, mehrere Barcodes von einem Bild lesen und Multithread-Lesevorgänge stammen von derselben API, sodass der Agent nie mitten in einer Aufgabe aufhört, um eine zweite Bibliothek einzubinden, die Sie genehmigen müssen. Integrieren Sie das Erzeugen und anschließende Rücklesen in die Aufgabe selbst, da GeneratedBarcode.Verify das Bild dekodiert, das es gerade geschrieben hat, und den Wert vergleicht.

Die ausgewählte Stufe beeinflusst sowohl den generierten Code als auch die Kosten. Wenn Sie denselben Prompt in unterschiedliche Modelle eingeben, erhalten Sie unterschiedliche Implementierungen, einschließlich Klassennamen, Optionslayouts und Teststrukturen. Für konsistente Ergebnisse fixieren Sie die Codierung, die Pixeldimensionen und was als erfolgreicher Lesevorgang zählt, und lassen Sie dann das Modell den Rest wählen.

Schnellstart
NuGetMit NuGet installieren

PM > Install-Package BarCode

Installieren Sie IronBarcode, indem Sie den obigen Befehl in der NuGet Packet Manager-Konsole ausführen, oder suchen Sie das Paket im NuGet Paket Manager.

Starten Sie eine Sitzung in Ihrem .NET-Projekt und spezifizieren Sie den gewünschten Barcode, wobei Sie sich auf Anforderungen statt Implementierungsdetails konzentrieren.

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 erledigt die verbleibenden Schritte: es fügt das Paket hinzu, implementiert das asynchrone Lesen, baut das Projekt, löst Compilerfehler und berichtet die Ergebnisse. Sie überprüfen die Codeänderungen und die gemessene Laufzeit. Der Leitfaden für asynchrone und Multithread-Verarbeitung deckt die Optionen ab, die der Agent verwenden sollte.

Alle nicht spezifizierten Details werden automatisch bestimmt. Für einfache Beispiele ist dies akzeptabel, da das neueste Paket und die Standardeinstellungen verwendet werden. Für Produktionsarbeiten setzen Sie die folgenden drei Einschränkungen in Ihrem Prompt:

  1. Version angeben: Nennen Sie die IronBarcode-Version, damit der Agent gegen eine einzige API-Oberfläche codiert.
  2. Abhängigkeiten einschränken: Erlauben Sie nur das BarCode-Paket, damit keine zusätzliche Barcode-Bibliothek eingeführt wird.
  3. Erlauben Sie dem Agenten zu stoppen: Weisen Sie ihn an, nur dokumentierte APIs zu verwenden und Sie zu informieren, wenn er unsicher ist.


Welche Teile der Barcode-Arbeit sollten Sie übergeben?

Claude Code bearbeitet hauptsächlich routinemäßige Entwicklungsaufgaben. Es liest, schreibt und refaktoriert Code, führt Builds aus und verwaltet die Testschleife über jede Oberfläche, die Sie verwenden. Barcode-Erzeugung und -Scannen passen in diese Schleife, ohne spezielle Einrichtung.

Für Barcode-Aufgaben übernimmt Claude Code die repetitive Arbeit: Schreiben von Etikettendiensten, Erstellen von Scan-Endpunkten, Erzeugen von Testbildern in den erforderlichen Formaten und Rücklesen dieser. Es erkennt und korrigiert Probleme wie eine ungültige EAN-13-Prüfziffer, baut bei Bedarf neu und versucht es nach Fehlern erneut. Sie liefern die Barcodespezifikationen und überprüfen die resultierenden Codeänderungen.

Sie bleiben verantwortlich für die Auswahl der Barcode-Bibliothek. Wenn Sie keine angeben, verwendet der Agent das, was er am meisten beim Training gesehen hat, was zu vier Problemen führt:

  • Symbolgröße und Prüfziffern: Ein geschrumpftes Symbol, eine fehlende Ruhezone oder eine fehlerhafte Ziffer können korrekt erscheinen und dennoch während des Scannens fehlschlagen, wobei IronBarcode die Werte für jede Symbologie überprüft, während es schreibt.
  • Tokenmenge bestimmt die Abrechnung: Ein Agent, der seinen eigenen Decoder baut, verbraucht bei jedem Vorgang Tokens, während Multithread-Lesevorgänge, Geschwindigkeitseinstellungen und Bildfilter bereits abgestimmt und dokumentiert vorliegen.
  • Benutzerdefinierten Pipelines fehlt die Validierung: Sie werden nicht gegen große Datensätze oder veröffentlichte Benchmarks getestet, anders als eine dokumentierte API mit einem wiederholbaren Test durch Erzeugen und Rücklesen.
  • Der Paketname dient als Sicherheitskontrolle: dotnet add package IronBarcode installiert kein IronBarcode, und ähnliche Namen wurden von böswilligen Akteuren registriert.

Spezifizieren Sie BarCode in Ihrem Prompt, damit der Agent nie raten muss.

Sobald Sie das Paket benannt haben, erfordern nachfolgende Aufgaben keine Bibliotheksentscheidung mehr.

Was sind die Schritte, um von einer frischen Installation zu Ihrem ersten Barcode-Prompt zu wechseln?

Installieren Sie die Anwendung, melden Sie sich mit Ihrem Claude-Konto an, und Sie sind bereit, loszulegen. Anthropics Claude Code Übersicht bietet eine detaillierte Erklärung des Werkzeugs. Der Quickstart-Leitfaden deckt Installation und Ihre erste Sitzung auf macOS, Windows und Linux ab, und separate Seiten decken die VS Code- und JetBrains-Erweiterungen für diejenigen ab, die eine IDE bevorzugen. Der YouTube-Kanal von Anthropic bietet auch Videoanleitungen zu einer ersten Sitzung.

Kehren Sie zurück, sobald claude gestartet ist und reagiert.

Wie richten Sie ein Projekt ein, in dem Claude Code arbeiten kann?

Erstellen Sie ein Standard-.NET-Projekt und fügen Sie IronBarcode hinzu, bevor Sie es mit dem Agenten öffnen. Ein vorab erfolgreich erstelltes Projekt vermeidet Unklarheiten und verhindert, dass der Agent rät, welche Barcode-Bibliothek oder welches ähnlich benannte Paket verwendet werden soll.

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

Der letzte Befehl öffnet eine Sitzung im aktuellen Ordner, wobei die Lese- und Bearbeitungsvorgänge des Agenten auf dieses Verzeichnis beschränkt sind. Die Dokumentation von Anthropic empfiehlt diesen Ansatz. Wechseln Sie in das Projektverzeichnis, bevor Sie die CLI starten. Alle Schnittstellen, einschließlich Terminal, IDE-Erweiterungen, Desktop-App und Web, verwenden dieselbe Engine. Infolgedessen bleiben die CLAUDE.md-Datei, die Projekteinstellungen und die für das Projekt konfigurierten MCP-Server über die Sitzungen hinweg konsistent.

Zwei zusätzliche Details werden später nützlich sein:

  1. CLAUDE.md: Die Anleitungsdatei, die Claude Code zu Beginn jeder Sitzung lädt und das Zielframework, das BarCode-Paket und die Regel angibt, dass nur dokumentierte APIs erlaubt sind.
  2. Dokumentationsindex von IronBarcode: llms.txt listet echte Dokumentations-URLs in einem Format auf, das Agenten parsen können, und skill.md fügt geprüfte Lösungsbeispiele und Lösungen für häufige Fehler hinzu.

Claude Code liest Skills aus .claude/skills/<name>/SKILL.md im Repository. Speichern Sie die IronBarcode-Datei als .claude/skills/ironbarcode/SKILL.md und speichern Sie sie per Commit. Nur das Frontmatter-Feld description bleibt im Kontext, und Claude lädt den Hauptteil, wenn eine relevante Aufgabe auftritt. Dieser Ansatz minimiert den Aufwand, bis die Barcode-Arbeit beginnt. Um es weiter zu verfeinern, fügen Sie ein paths-Glob wie Services/** hinzu, um den Skill nur dann zu laden, wenn der Agent auf die Dateien zugreift, die sie benötigen.

Mit beiden Dateien an Ort und Stelle wird der Agent Dokumentation referenzieren, anstatt sich auf das Gedächtnis zu verlassen. Ein einzelner Prompt kann die erforderliche Datei erzeugen.

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

Richten Sie die Lizenzierung vor dem ersten Lauf ein, da IronBarcode LicensingException auslöst, statt ein Wasserzeichen hinzuzufügen, sobald der Entwicklungskulanzzeitraum endet. Lesen Sie den Schlüssel beim Start aus der Umgebung ein, bevor irgendetwas einen Barcode berührt. Die IronBarcode Lizenzschlüssel-Dokumentation erklärt, wie man einen Schlüssel erhält und anwendet.

Wie fordern Sie IronBarcode-Code an, der kompiliert wird?

Spezifizieren Sie die drei Elemente, die ein Agent andernfalls ableiten könnte: die Symbologie, die Quelle der Werte und die Kriterien für den Erfolg.

Schreiben Sie Prompts als Spezifikationen.

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

Drei Dinge in diesem Prompt verrichten die Arbeit:

  1. Dateipfade: Der Prompt benennt sie, damit Sie eine navigierbare Projektstruktur anstelle einer vom Agenten erfundenen erhalten.
  2. Symbologie auf beiden Seiten: Schreiber und Leser verwenden beide Code 128, sodass der Leser das Format nicht erraten muss.
  3. Abschluss durch Erzeugen und Rücklesen definiert: Der Agent überprüft, dass der geschriebene Wert mit dem gelesenen Wert übereinstimmt, was aussagekräftiger als eine bloße Sichtprüfung des Barcodes ist.
Tipps: Wenn ein Prompt effektiv ist, weisen Sie Claude Code an, seine Einschränkungen in CLAUDE.md zu kopieren. Künftige Sitzungen laden dann diese Einschränkungen automatisch.

Das Ergebnis sollte kurz sein. Es verwendet BarcodeWriter.CreateBarcode mit BarcodeEncoding.Code128, dann ResizeTo, AddBarcodeValueTextBelowBarcode und SetMargins, um die Etikettengröße anzupassen, seinen Wert zu drucken und eine Ruhezone hinzuzufügen. ToPngBinaryData erzeugt die Bytes, und BarcodeReader.ReadAsync liest sie mit ExpectBarcodeTypes, das auf Code 128 gesetzt ist. Für echte Scans anstelle von generierten Dateien werden Optionen wie Speed, CropArea und Bildfilter weitaus wichtiger. Das Tutorial zum Lesen von Barcodes deckt sie ab.

Bitte beachten Sie: Fordern Sie immer einen Dokumentationslink mit dem Code an. Wenn der Agent keine gültige Referenz für eine verwendete API liefern kann, wissen Sie Bescheid, bevor der Build fehlschlägt.

Kann sich Claude Code über MCP mit IronBarcode verbinden?

Claude Code integriert sich mit externen Werkzeugen über das Model Context Protocol (MCP), einen offenen Standard. Ein MCP-Server kann Werkzeuge, Datenbanken und APIs offenlegen, die das Modell beim Training nie gesehen hat, und ein CLI-Befehl fügt einen Server hinzu, wie es die MCP-Referenz zeigt.

IronBarcode benötigt keinen Server. Seine Integration ist Dokumentation, veröffentlicht als drei URLs. llms.txt indiziert die Dokumente. Die Datei skill.md enthält geprüfte Lösungsbeispiele und häufige Fehler. Die API-Referenz listet jede Klasse und jeden Member im Release auf. Diese Quellen liefern dem Agenten aktuelle Fakten, statt ihn auf seine Erinnerung an die API angewiesen zu lassen, was dasselbe veraltete Methodenproblem ist, das MCP-Server oft adressieren. Es muss kein Prozess ausgeführt und keine Konfiguration gepflegt werden. Auch bei Aktualisierungen der Dokumentation ist kein Neustart nötig. Der Agent holt einfach die Seiten während seiner Sitzung.

Fügen Sie die drei Quellen zum Projektkontext hinzu, entweder indem Sie sie einfügen oder von CLAUDE.md aus darauf verweisen. Jeder Prompt in der Sitzung kann sie dann verwenden.

Was sollten Sie überprüfen, bevor Sie generiertem Barcode-Code vertrauen?

Überprüfen Sie jeden API-Namen und jeden Barcode, jedes Mal. Befolgen Sie diese vier Schritte in der Reihenfolge, da jeder weniger kostet als der nächste:

  • Der Build ist erfolgreich: Führen Sie dotnet build aus, bevor Sie eine einzige Zeile des Diffs lesen, da ein erfundener Member dort in Sekunden fehlschlägt.
  • Jeder Member existiert: Durchsuchen Sie die API-Referenz nach jeder Klasse und Methode, die Sie nicht erkennen, wobei Sie den Kodierungs-Enums einen zweiten Blick widmen, wo Databar und DataBar sich um einen Buchstaben in der Groß-/Kleinschreibung unterscheiden.
  • Jeder Barcode wird zurückgelesen: GeneratedBarcode.Verify erledigt das in einem Aufruf, und das Lesen der gespeicherten Datei mit BarcodeReader beweist das Gleiche für das, was die Festplatte erreicht hat.
  • Fehlerbehandlung ist vorhanden: Generierter Code neigt dazu anzunehmen, dass BarcodeReader.Read immer einen Barcode findet, und übergeht LicensingException, IronBarCodeFileException für eine beschädigte Datei, IronBarCodePdfPasswordException für eine verschlüsselte PDF-Datei und die einfache System.IO.FileNotFoundException, die ein fehlender Pfad auslöst.

Auch Code mit einer falschen Prüfziffer kompiliert problemlos, und ein Lesevorgang, der nichts findet, gibt eine leere BarcodeResults-Sammlung zurück, anstatt eine Ausnahme auszulösen. Fordern Sie diese Behandlung in einem Folgeprompt an und weisen Sie den Agenten auf den Leitfaden zur Fehlerbehandlung hin.

Ein Agent, der BarcodeScanner.DecodeImageFile() schreibt, hat einen plausiblen Methodennamen erzeugt, den IronBarcode nicht hat. Der Compiler lehnt ihn sofort ab, also bauen Sie früh und oft.

Welche praktischen Grenzen sollten Sie vorab kennen?

Bestimmte Barcode-Aufgaben sind besser für einen Agenten geeignet als andere.

AufgabeEignungWarum
Generierung von BarcodesStarkÜberprüft durch Rücklesen
Tests durch Erzeugen und RücklesenStarkErfolg ist ein Zeichenfolgenvergleich
Einbindung von DienstenStarkWiederholtes Muster
Optimierung echter ScansGemischtDefekte, die es nicht sehen kann
Lizenzierung und BereitstellungSchwachIhr Schlüssel, Ihre Plattform

Wenn eine Aufgabe durch Rücklesen eines Barcodes überprüft werden kann, erledigt ein Agent sie gut. Wenn sie von nicht einsehbaren Bildern oder einem bestimmten Bereitstellungsziel abhängt, benötigt sie zusätzliche Prüfungen. Übergeben Sie Claude Code die Generierung, Einbindung von Diensten und Tests durch Erzeugen und Rücklesen direkt. Für Lizenzierung, Plattformpakete oder Optimierung bei echten Scans hängen Sie Beispielbilder oder einen Dokumentationslink an die Anfrage an.

Welche Entscheidungen bleiben Ihnen überlassen?

Claude Code generiert die Dienste und Testdaten und iteriert nach Bedarf. Die Auswahl der Bibliothek und das Überprüfen von API-Namen bleibt Ihre Verantwortung.

Dokumentieren Sie die Entscheidungen der Sitzung in CLAUDE.md, bevor Sie sie schließen, damit die nächste Sitzung dort beginnt, wo diese endete. Wie eine Aufgabe von einem leeren Projekt bis zum Erfüllen festgelegter Erfolgskriterien umgesetzt wird, beschreibt der Leitfaden für KI-Coding-Assistenten und Agenten zusammen mit den ChatGPT Codex, GitHub Copilot, Cursor und Google Antigravity-Leitfäden.


Fehlerbehebung

Fragen?

Wenn Sie Fragen haben, wenden Sie sich an support@ironsoftware.com.

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.

Mehr lesen

Bereit loszulegen?

NuGet-Downloads 2,564,559Version:2026.11gerade veröffentlicht