Delegando Trabalho do IronBarcode para o Claude Code

Curtis Chau
Curtis Chau
Atualizado: 21 de setembro de 2026

Três fatos decidem se uma tarefa de código de barras é bem-sucedida. O pacote NuGet é BarCode, a chave de licença vem do ambiente, e o trabalho está inacabado até que a imagem tenha sido decodificada e comparada com o valor escrito. Claude Code é a ferramenta nesta série que mantém esses fatos no repositório ao invés do seu prompt. Ele lê CLAUDE.md no início de cada conversa e carrega .claude/skills/ironbarcode/SKILL.md assim que uma tarefa envolve código de barras, preenchendo a função para a qual o skill.md publicado pelo IronBarcode foi criado.

Essas regras valem independentemente do modelo que as lê, e o modelo que você escolhe é sua principal alavanca de custo. A opção /model sonnet é suficiente para a maioria das tarefas de código de barras, como conectar um serviço de etiquetas e executar conjuntos de teste. A opção /model opusplan usa Opus para planejamento e Sonnet para implementação, o que é benéfico para migrações complexas onde o mapeamento de código é crítico. O alias fable, que se resolve para Fable 5.1, e o alias haiku para tarefas simples também estão disponíveis, e você pode alternar modelos durante uma sessão.

Um pacote cobre todo o trabalho, o que conta mais para um agente do que para uma pessoa. A geração de códigos de barras 1D e 2D, vários códigos de barras lidos de uma única imagem, e leituras multithread vêm da mesma API, então o agente nunca para no meio da tarefa para puxar uma segunda biblioteca para você aprovar. Inclua o ciclo de geração e leitura na própria tarefa, já que GeneratedBarcode.Verify decodifica a imagem que acabou de escrever e compara o valor.

O nível selecionado afeta tanto o código gerado quanto o custo. Fornecer o mesmo prompt para diferentes modelos gera implementações distintas, incluindo nomes de classes, layouts de opções e estruturas de teste. Para uma saída consistente, fixe a codificação, as dimensões dos pixels e o que conta como uma leitura bem-sucedida, depois deixe o modelo escolher o resto.

Início Rápido
NuGetInstalar com NuGet

PM > Install-Package BarCode

Instale o IronBarcode executando o comando acima no Console do Gerenciador de Pacotes NuGet, ou procure pelo pacote no Gerenciador de Pacotes NuGet.

Inicie uma sessão em seu projeto .NET e especifique o código de barras desejado, focando nos requisitos ao invés dos detalhes de implementação.

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 as etapas restantes: ele adiciona o pacote, conecta a leitura assíncrona, compila o projeto, resolve quaisquer erros de compilação e relata os resultados. Você revisa as alterações de código e o tempo medido. O guia assíncrono e multithread cobre as opções que ele deve usar.

Quaisquer detalhes não especificados são determinados automaticamente. Para exemplos simples, isso é aceitável, uma vez que o pacote mais recente e as configurações padrão são usados. Para trabalho em produção, defina as seguintes três restrições em seu prompt:

  1. Especifique a versão: nomeie a versão do IronBarcode para que o agente programe com base em uma única versão da API.
  2. Restrinja dependências: permita apenas o pacote BarCode, para que nenhuma biblioteca adicional de código de barras seja introduzida.
  3. Permita que o agente pare: instrua-o a usar apenas APIs documentadas e a lhe informar quando estiver em dúvida.


Quais partes do trabalho de código de barras você deve delegar?

Claude Code lida principalmente com tarefas rotineiras de desenvolvimento. Ele lê, escreve e refatora código, executa builds e gerencia o ciclo de testes em qualquer interface que você usar. Geração e escaneamento de código de barras se encaixam nesse ciclo sem necessidade de configuração especial.

Para tarefas de código de barras, Claude Code gerencia o trabalho repetitivo: escrevendo serviços de etiquetas, criando endpoints de escaneamento, gerando imagens de teste nos formatos requeridos, e lendo-as de volta. Ele detecta e corrige problemas como um dígito verificador EAN-13 inválido, reconstrói conforme necessário e tenta novamente após erros. Você fornece as especificações do código de barras e revisa as alterações de código resultantes.

Você continua responsável por selecionar a biblioteca de códigos de barras. Se você não especificar uma, o agente usa por padrão o que mais viu no treinamento, o que leva a quatro problemas:

  • Tamanho do símbolo e dígitos verificadores: um símbolo encolhido, uma margem de silêncio ausente ou um dígito incorreto pode parecer correto e ainda falhar durante o escaneamento, onde o IronBarcode valida valores para cada simbologia enquanto escreve.
  • Volume de tokens determina a cobrança: um agente que constrói seu próprio decodificador paga tokens em cada operação, enquanto leituras multithread, presets de velocidade e filtros de imagem chegam já ajustados e documentados.
  • Pipelines personalizados não têm validação: eles não são testados contra grandes conjuntos de dados ou benchmarks publicados, ao contrário de uma API documentada com um teste de ida e volta repetível.
  • O nome do pacote atua como controle de segurança: dotnet add package IronBarcode não instala o IronBarcode, e nomes semelhantes foram registrados por atores maliciosos.

Especifique BarCode no seu prompt para que o agente nunca precise adivinhar.

Uma vez que você nomeia o pacote, tarefas subsequentes não precisam mais de uma decisão de biblioteca.

Quais são os passos para ir de uma instalação nova ao seu primeiro prompt de código de barras?

Instale o aplicativo, faça login com sua conta Claude, e você está pronto para começar. A visão geral do Claude Code da Anthropic fornece uma explicação detalhada da ferramenta. O guia rápido cobre a instalação e sua primeira sessão no macOS, Windows e Linux, e páginas separadas cobrem as extensões VS Code e JetBrains para quem prefere um IDE. O canal do Youtube da Anthropic também oferece tutoriais em vídeo de uma sessão inicial.

Volte assim que claude tiver iniciado e estiver responsivo.

Como você configura um projeto no qual o Claude Code pode trabalhar?

Crie um projeto .NET padrão e adicione IronBarcode antes de abri-lo com o agente. Garantir que o projeto compile antes de começar elimina confusão e impede o agente de adivinhar qual biblioteca de códigos de barras, ou qual pacote de nome semelhante, usar.

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

O comando final abre uma sessão na pasta atual, restringindo as leituras e edições do agente a esse diretório. A documentação da Anthropic recomenda essa abordagem. Mude para o diretório do projeto antes de iniciar a CLI. Todas as interfaces, incluindo o terminal, extensões de IDE, aplicativo de desktop e web, usam o mesmo mecanismo. Como resultado, o arquivo CLAUDE.md, as configurações do projeto, e os servidores MCP configurados para o projeto permanecem consistentes entre sessões.

Dois detalhes adicionais serão benéficos mais tarde:

  1. CLAUDE.md: o arquivo de instruções que o Claude Code carrega no início de cada sessão, nomeando o framework alvo, o pacote BarCode, e a regra que apenas APIs documentadas são permitidas.
  2. Índice de documentação do IronBarcode: llms.txt lista URLs de documentação reais em um formato que os agentes podem analisar, e skill.md adiciona receitas verificadas e correções para falhas comuns.

Claude Code lê skills de .claude/skills/<name>/SKILL.md no repositório. Salve o arquivo do IronBarcode como .claude/skills/ironbarcode/SKILL.md e versione-o. Somente o campo description do frontmatter permanece no contexto, e Claude carrega o corpo quando uma tarefa relevante surge. Essa abordagem minimiza a sobrecarga até que o trabalho de código de barras comece. Para refiná-la ainda mais, adicione um glob paths como Services/** para carregar a skill apenas quando o agente acessar os arquivos que precisam dela.

Com ambos os arquivos no lugar, o agente referenciará a documentação ao invés de confiar na memória. Um único prompt pode gerar o arquivo necessário.

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 o licenciamento antes da primeira execução, porque o IronBarcode lança LicensingException em vez de aplicar uma marca d’água após o fim do período de tolerância para desenvolvimento. Carregue a chave do ambiente na inicialização, antes de qualquer operação com códigos de barras. A documentação de Chaves de licença do IronBarcode explica como obter e aplicar uma chave.

Como você solicita código do IronBarcode que compila?

Especifique os três elementos que um agente pode inferir: a simbologia, a fonte dos valores, e os critérios de sucesso.

Escreva prompts como especificações.

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

Três coisas nesse prompt fazem o trabalho:

  1. Caminhos de arquivo: o prompt os nomeia, então você obtém uma estrutura de projeto navegável ao invés de uma que o agente inventa.
  2. Simbologia em ambos os lados: escritor e leitor usam ambos Code 128, o que remove qualquer necessidade do leitor adivinhar o formato.
  3. Conclusão definida como um ciclo de geração e leitura: o agente verifica se o valor escrito corresponde ao valor lido, o que é mais confiável do que conferir a aparência do código de barras.
Dicas: Quando um prompt é eficaz, instrua o Claude Code a copiar suas restrições em CLAUDE.md. Sessões futuras então carregarão essas restrições automaticamente.

O resultado deve ser curto. Ele usa BarcodeWriter.CreateBarcode com BarcodeEncoding.Code128, depois ResizeTo, AddBarcodeValueTextBelowBarcode, e SetMargins para dimensionar a etiqueta, imprimir seu valor, e adicionar uma margem de silêncio. ToPngBinaryData produz os bytes, e BarcodeReader.ReadAsync os lê com ExpectBarcodeTypes definido para o Code 128. Para escaneamentos reais ao invés de arquivos gerados, opções como Speed, CropArea, e filtros de imagem tornam-se muito mais importantes. O tutorial do Leitor de Códigos de Barras aborda isso.

Por favor, note: Sempre solicite um link de documentação com o código. Se o agente não puder fornecer uma referência válida para uma API que usou, você saberá antes de a compilação falhar.

Claude Code pode se conectar ao IronBarcode através do MCP?

Claude Code integra-se com ferramentas externas por meio do Protocolo de Contexto do Modelo (MCP), um padrão aberto. Um servidor MCP pode expor ferramentas, bancos de dados e APIs que o modelo nunca viu no treinamento, e um comando CLI adiciona um servidor, como mostra a referência de MCP.

IronBarcode não precisa de um servidor. Sua integração é documentação, publicada como três URLs. llms.txt indexa os documentos. O arquivo skill.md mantém receitas verificadas e falhas comuns. A referência de API lista todas as classes e membros no lançamento. Ler isso dá ao agente fatos atuais ao invés de uma API lembrada, que é o mesmo problema de método desatualizado que os servidores MCP frequentemente resolvem. Não há processo para executar, nenhuma configuração para manter, e nenhuma reinicialização quando os docs são atualizados. O agente simplesmente busca as páginas durante sua sessão.

Adicione as três fontes ao contexto do projeto, seja colando-as ou referenciando-as de CLAUDE.md. Cada prompt na sessão pode então usá-las.

O que você deve verificar antes de confiar no código de barras gerado?

Verifique cada nome de API e cada código de barras, a cada vez. Siga estes quatro passos em ordem, pois cada um é menos custoso que o próximo:

  • O projeto compila: execute dotnet build antes de ler uma linha do diff, já que um membro inventado falha lá em segundos.
  • Cada membro existe: pesquise a referência de API para cada classe e método que você não reconhece, dando uma segunda olhada nos enums de codificação onde Databar e DataBar diferem no uso de maiúscula ou minúscula em uma letra.
  • Cada código de barras é escaneado de volta: GeneratedBarcode.Verify resolve isso em uma chamada, e ler o arquivo salvo com BarcodeReader prova o mesmo sobre o que chegou ao disco.
  • O tratamento de erros está implementado: código gerado tende a assumir que BarcodeReader.Read sempre encontra um código de barras, e a ignorar LicensingException, IronBarCodeFileException para um arquivo corrompido, IronBarCodePdfPasswordException para um PDF criptografado, e o simples System.IO.FileNotFoundException que um caminho ausente lança.

Um dígito verificador incorreto compila perfeitamente bem, e uma leitura que não encontra nada retorna uma coleção BarcodeResults vazia em vez de lançar uma exceção. Solicite esse tratamento em um prompt de acompanhamento e aponte o agente para o guia de tratamento de erros.

Um agente que escreve BarcodeScanner.DecodeImageFile() produziu um nome de método plausível que o IronBarcode não possui. O compilador rejeita isso na hora, então compile desde o início e com frequência.

Quais são os limites práticos que vale a pena saber de antemão?

Certas tarefas de códigos de barras são mais adequadas para um agente do que outras.

TarefaAdequaçãoPor quê
Geração de códigos de barrasForteVerificado lendo de volta
Testes de ida e voltaForteA aprovação depende da correspondência entre strings
Integração de serviçosFortePadrão repetido
Ajuste de digitalizações reaisMistoDefeitos que não pode ver
Licenciamento e implantaçãoFracoSua chave, sua plataforma

Se uma tarefa pode ser verificada lendo um código de barras de volta, um agente a faz bem. Se depende de imagens não vistas ou de um alvo de implantação particular, precisa de mais verificação. Entregue ao Claude Code a geração, conexão e testes de ida e volta diretamente. Para licenciamento, pacotes de plataforma ou ajuste em escaneamentos reais, anexe imagens de amostra ou um link de documentação à solicitação.

Quais decisões permanecem suas?

Claude Code gera os serviços e dados de teste e itera conforme necessário. Selecionar a biblioteca e verificar nomes de API continuam sendo sua responsabilidade.

Documente as decisões da sessão em CLAUDE.md antes de fechá-la, para que a próxima sessão comece onde esta terminou. Uma tarefa levada de um projeto vazio para um critério de aprovação definido é descrita no guia de assistentes e agentes de codificação de IA, junto com os guias ChatGPT Codex, GitHub Copilot, Cursor e Google Antigravity.


Solução de problemas

Dúvidas?

Se você tiver dúvidas, entre em contato com support@ironsoftware.com

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.

Leia Mais

Pronto para começar?

Downloads no NuGet 2,564,559Versão:2026.11recém-lançado