Delegando el trabajo de IronBarcode a Claude Code

Curtis Chau
Curtis Chau
Actualizado: 21 de septiembre de 2026

Tres hechos deciden si una tarea de código de barras tiene éxito. El paquete de NuGet es BarCode, la clave de licencia proviene del entorno, y el trabajo no está terminado hasta que la imagen se haya decodificado y comparado con el valor escrito. Claude Code es la herramienta en esta serie que mantiene esos hechos en el repositorio en lugar de en su indicación. Lee CLAUDE.md al inicio de cada conversación y carga .claude/skills/ironbarcode/SKILL.md una vez que una tarea toca el código de barras, que es la ubicación para la que se diseñó el archivo skill.md publicado por IronBarcode.

Esas reglas se mantienen sea cual sea el modelo que las lea, y el modelo que elija es su principal herramienta para controlar el costo. La opción /model sonnet es suficiente para la mayoría de las tareas de código de barras, como conectar un servicio de etiquetado y ejecutar conjuntos de pruebas. La opción /model opusplan usa Opus para la planificación y Sonnet para la implementación, lo cual es beneficioso para migraciones complejas donde el mapeo del código es crítico. También están disponibles el alias fable, que se resuelve en Fable 5.1, y el alias haiku para tareas simples, y puede cambiar de modelo durante una sesión.

Un paquete cubre todo el trabajo, lo que cuenta más para un agente que para una persona. La escritura 1D y 2D, varios códigos de barras leídos de una imagen, y lecturas multihilo provienen de la misma API, por lo que el agente nunca se detiene a mitad de tarea para traer una segunda biblioteca para que la apruebe. Incorpore el ciclo de escritura y lectura en la tarea misma, ya que GeneratedBarcode.Verify decodifica la imagen que acaba de escribir y compara el valor.

El nivel seleccionado afecta tanto al código generado como al costo. Proporcionar la misma indicación a diferentes modelos produce implementaciones distintas, incluyendo nombres de clases, distribuciones de opciones y estructuras de prueba. Para obtener una salida constante, fije la codificación, las dimensiones de píxeles y qué cuenta como una lectura exitosa, y deje que el modelo elija el resto.

Inicio rápido
NuGetInstalar con NuGet

PM > Install-Package BarCode

Instale IronBarcode ejecutando el comando arriba en la Consola del Administrador de Paquetes NuGet, o busque el paquete en el Administrador de Paquetes NuGet.

Inicie una sesión en su proyecto .NET y especifique el código de barras deseado, enfocándose en los requisitos en lugar de en los detalles de implementación.

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 completa los pasos restantes: añade el paquete, conecta la lectura asíncrona, compila el proyecto, resuelve cualquier error de compilación y reporta los resultados. Revise los cambios de código y el tiempo que midió. La guía de asincronía y multihilo cubre las opciones que debería utilizar.

Cualquier detalle no especificado se determina automáticamente. Para ejemplos simples, esto es aceptable, ya que se utiliza el paquete más reciente y la configuración predeterminada. Para trabajos de producción, establezca las siguientes tres restricciones en su indicación:

  1. Especifique la versión: indique la versión de IronBarcode para que el agente programe con una única versión de la API.
  2. Restrinja las dependencias: permita solo el paquete BarCode, para que no se introduzca ninguna biblioteca adicional de código de barras.
  3. Permita que el agente se detenga: indíquele que use solo APIs documentadas y que le informe cuando tenga dudas.


¿Qué partes del trabajo de código de barras debería delegar?

Claude Code maneja principalmente tareas de desarrollo rutinarias. Lee, escribe y refactoriza código, ejecuta compilaciones, y gestiona el ciclo de pruebas desde cualquier superficie que utilice. La generación y el escaneo de códigos de barras encajan en ese ciclo sin configuración especial.

Para tareas de código de barras, Claude Code gestiona el trabajo repetitivo: escribir servicios de etiquetado, crear puntos finales de escaneo, generar imágenes de prueba en los formatos necesarios y leerlas de vuelta. Detecta y corrige problemas como un dígito de control EAN-13 inválido, vuelve a compilar según sea necesario y vuelve a intentarlo después de errores. Usted proporciona las especificaciones de los códigos de barras y revisa los cambios de código resultantes.

Sigue siendo responsable de seleccionar la biblioteca de códigos de barras. Si no especifica una, el agente elige por defecto lo que más vio en el entrenamiento, lo que lleva a cuatro problemas:

  • Tamaño del símbolo y dígitos de control: un símbolo reducido, una zona de silencio faltante o un dígito erróneo pueden parecer correctos y aun así fallar durante el escaneo, donde IronBarcode valida los valores para cada simbología mientras escribe.
  • El volumen de tokens determina la facturación: un agente que construye su propio decodificador paga tokens en cada operación, mientras que las lecturas multihilo, los ajustes de velocidad y los filtros de imagen llegan ya ajustados y documentados.
  • Las canalizaciones personalizadas carecen de validación: no se prueban contra grandes conjuntos de datos o resultados de pruebas de rendimiento publicados, a diferencia de una API documentada con una prueba de ida y vuelta repetible.
  • El nombre del paquete actúa como un control de seguridad: dotnet add package IronBarcode no instala IronBarcode, y nombres similares han sido registrados por actores maliciosos.

Especifique BarCode en su indicación para que el agente nunca tenga que adivinar.

Una vez que indica el paquete, las tareas posteriores ya no requieren una decisión de biblioteca.

¿Cuáles son los pasos para pasar de una instalación nueva a su primera indicación de código de barras?

Instale la aplicación, inicie sesión con su cuenta de Claude y estará listo para comenzar. La visión general de Claude Code de Anthropic proporciona una explicación detallada de la herramienta. La guía de inicio rápido cubre la instalación y su primera sesión en macOS, Windows y Linux, y páginas separadas cubren las extensiones de VS Code y JetBrains para aquellos que prefieren un IDE. El canal de YouTube de Anthropic también ofrece recorridos en video de una sesión inicial.

Regrese una vez que claude se haya iniciado y responda.

¿Cómo configura un proyecto en el que Claude Code pueda trabajar?

Cree un proyecto estándar .NET y añada IronBarcode antes de abrirlo con el agente. Asegurarse de que el proyecto compile correctamente de antemano elimina confusiones y evita que el agente adivine qué biblioteca de códigos de barras, o qué paquete de nombre similar, usar.

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

El comando final abre una sesión en el directorio actual, restringiendo las lecturas y ediciones del agente a ese directorio. La documentación de Anthropic recomienda este enfoque. Cambie al directorio del proyecto antes de iniciar la CLI. Todas las interfaces, incluido el terminal, extensiones de IDE, aplicación de escritorio y web, usan el mismo motor. Como resultado, el archivo CLAUDE.md, la configuración del proyecto y los servidores MCP configurados para el proyecto permanecen consistentes a través de las sesiones.

Dos detalles adicionales serán beneficiosos más tarde:

  1. CLAUDE.md: el archivo de instrucciones que Claude Code carga al inicio de cada sesión, nombrando el marco de trabajo objetivo, el paquete BarCode, y la regla de que solo están permitidas las APIs documentadas.
  2. Índice de documentación de IronBarcode: llms.txt enumera URLs de documentación reales en un formato que los agentes pueden analizar, y skill.md añade recetas verificadas y correcciones para fallas comunes.

Claude Code lee habilidades de .claude/skills/<name>/SKILL.md en el repositorio. Guarde el archivo de IronBarcode como .claude/skills/ironbarcode/SKILL.md y regístrelo en el repositorio. Solo el frontmatter description permanece en contexto, y Claude carga el cuerpo cuando surge una tarea relevante. Este enfoque minimiza el gasto de recursos hasta que comienza el trabajo de códigos de barras. Para afinarlo más, añada un glob paths como Services/** para cargar la habilidad solo cuando el agente acceda a los archivos que lo necesitan.

Con ambos archivos en su lugar, el agente referenciará documentación en lugar de depender de la memoria. Una sola indicación puede generar el archivo requerido.

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

Configure la licencia antes de la primera ejecución, porque IronBarcode genera LicensingException en lugar de añadir una marca de agua una vez que finaliza el periodo de gracia de desarrollo. Obtenga la clave del entorno durante el inicio, antes de cualquier operación con códigos de barras. La documentación de Claves de Licencia de IronBarcode explica cómo obtener y aplicar una clave.

¿Cómo solicita código de IronBarcode que compile?

Especifique los tres elementos que un agente podría inferir: la simbología, la fuente de los valores y los criterios para el éxito.

Escriba las indicaciones como especificaciones.

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

Tres cosas en esa indicación realizan el trabajo:

  1. Rutas de archivos: la indicación las nombra, para que obtenga una estructura de proyecto navegable en lugar de una que el agente invente.
  2. Simbología en ambos lados: escritor y lector usan Code 128, lo que elimina cualquier necesidad de que el lector adivine el formato.
  3. La finalización definida como un recorrido completo: el agente verifica que el valor escrito coincide con el valor leído, lo que supera a confirmar la apariencia del código de barras.
Consejos: Cuando una indicación es efectiva, indique a Claude Code que copie sus restricciones en CLAUDE.md. Las sesiones futuras cargarán estas restricciones automáticamente.

El resultado debe ser breve. Usa BarcodeWriter.CreateBarcode con BarcodeEncoding.Code128, luego ResizeTo, AddBarcodeValueTextBelowBarcode, y SetMargins para dimensionar la etiqueta, imprimir su valor y agregar una zona de silencio. ToPngBinaryData produce los bytes, y BarcodeReader.ReadAsync los lee con ExpectBarcodeTypes configurado a Code 128. Para escaneos reales en lugar de archivos generados, opciones como Speed, CropArea, y filtros de imagen se vuelven mucho más importantes. El tutorial de lector de códigos de barras los cubre.

Por favor, tenga en cuenta: Siempre solicite un enlace de documentación junto con el código. Si el agente no puede proporcionar una referencia válida para una API que usó, lo sabrá antes de que falle la compilación.

¿Puede Claude Code conectarse a IronBarcode a través de MCP?

Claude Code se integra con herramientas externas a través del Model Context Protocol (MCP), un estándar abierto. Un servidor MCP puede exponer herramientas, bases de datos y APIs que el modelo nunca vio en el entrenamiento, y un comando CLI añade un servidor, como muestra la referencia MCP.

IronBarcode no necesita un servidor. Su integración es documentación, publicada como tres URLs. llms.txt indexa los documentos. El archivo skill.md contiene recetas verificadas y fallas comunes. La referencia de API enumera cada clase y miembro en la versión. Leer estos proporciona al agente datos actuales en lugar de una API recordada, lo cual es el mismo problema de método obsoleto que los servidores MCP a menudo abordan. No hay proceso para ejecutar, no hay configuración que mantener, y no hay reinicio cuando se actualizan los documentos. El agente simplemente obtiene las páginas durante su sesión.

Agregue las tres fuentes al contexto del proyecto, ya sea pegándolas o referenciándolas desde CLAUDE.md. Así, todas las indicaciones de la sesión podrán utilizarlas.

¿Qué debería verificar antes de confiar en el código generado para códigos de barras?

Verifique cada nombre de API y cada código de barras, cada vez. Siga estos cuatro pasos en orden, ya que cada uno es menos costoso que el siguiente:

  • La compilación pasa: ejecute dotnet build antes de leer una línea del diff, ya que un miembro inventado falla allí en segundos.
  • Cada miembro existe: busque en la referencia de API cada clase y método que no reconozca, prestando especial atención a las enumeraciones de codificación donde Databar y DataBar difieren por una letra en mayúsculas.
  • Cada código de barras se puede volver a leer: GeneratedBarcode.Verify lo resuelve en una sola llamada, y leer el archivo guardado con BarcodeReader demuestra lo mismo sobre lo que llegó al disco.
  • El manejo de errores está en su lugar: el código generado tiende a asumir que BarcodeReader.Read siempre encuentra un código de barras, y a pasar por alto LicensingException, IronBarCodeFileException para un archivo corrupto, IronBarCodePdfPasswordException para un PDF encriptado, y el System.IO.FileNotFoundException común que lanza una ruta faltante.

Un dígito de control incorrecto se compila perfectamente bien, y una lectura que no encuentra nada devuelve una colección BarcodeResults vacía en lugar de lanzar una excepción. Solicite ese manejo en una indicación de seguimiento y señale al agente la guía de manejo de errores.

Un agente que escribe BarcodeScanner.DecodeImageFile() ha producido un nombre de método plausible que IronBarcode no tiene. El compilador lo rechaza en el acto, así que compile desde el principio y con frecuencia.

¿Cuáles son los límites prácticos que vale la pena conocer de antemano?

Ciertas tareas de código de barras son más adecuadas para un agente que otras.

TareaIdoneidadPor qué
Generación de códigos de barrasAltaSe verifica mediante una nueva lectura
Pruebas de ida y vueltaAltaLa prueba se aprueba si las cadenas coinciden
Integración de serviciosAltaPatrón repetido
Ajuste de escaneos realesVariableDefectos que no puede ver
Licencias y despliegueBajaSu clave, su plataforma

Si una tarea se puede verificar leyendo de vuelta un código de barras, un agente lo hace bien. Si depende de imágenes no vistas o de un objetivo de despliegue particular, necesita más verificación. Delegue en Claude Code la generación, integración y pruebas de ida y vuelta directamente. Para licencias, paquetes de plataforma o ajustes en escaneos reales, adjunte imágenes de muestra o un enlace de documentación a la solicitud.

¿Qué decisiones siguen siendo suyas?

Claude Code genera los servicios y los datos de prueba, e itera según sea necesario. La selección de la biblioteca y la verificación de nombres de API siguen siendo su responsabilidad.

Documente las decisiones de la sesión en CLAUDE.md antes de cerrarla, para que la próxima sesión comience donde terminó esta. La guía de asistentes y agentes de programación con IA documenta una tarea desde un proyecto vacío hasta el cumplimiento de un criterio de aprobación definido, junto con las guías de ChatGPT Codex, GitHub Copilot, Cursor, y Google Antigravity.


Solución de problemas

¿Preguntas?

Si tiene alguna pregunta, contacte a support@ironsoftware.com

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.

Leer más

¿Listo para empezar?

Descargas de NuGet 2,564,559Versión:2026.11recién lanzado