Solicitando código do ChatGPT Codex para IronBarcode que compila

Curtis Chau
Curtis Chau
Atualizado: 21 de setembro de 2026

IronBarcode fornece dois enums de codificação cujos nomes diferem no uso de maiúsculas e minúsculas, BarcodeEncoding.Databar e BarcodeWriterEncoding.DataBar, e um modelo que trabalha de memória os confunde. Um compilador detecta isso imediatamente, o que é o argumento para um agente que compila o código que escreve. O ChatGPT Codex trabalha dentro do repositório, então ele executa dotnet build e lê o erro ele mesmo. As falhas mais silenciosas custam mais, como um leitor configurado para pesquisar todas as simbologias quando cada etiqueta no lote é Code 128.

Essa diferença decide qual nível executar. Codex abrange a família GPT-5.6, e /model alterna entre Sol, Terra e Luna dentro de uma sessão interativa. Um ciclo de recompilação e nova leitura sobre um conjunto de testes fixo é uma tarefa de baixo custo que Luna executa a 5 créditos por milhão de tokens de entrada, contra 100 para Sol. Terra é o nível médio com 50 créditos por milhão de entrada e 300 por milhão de saída, e é um padrão razoável quando um projeto já contém mais do que um conjunto de testes. Reserve Sol, o carro-chefe da família, para trabalhos de diagnóstico mais difíceis, como um lote de fotos de armazém que falha ao decodificar sem reportar uma causa.

O IronBarcode lê e escreve símbolos 1D e 2D por meio de uma API comercial .NET. O Codex lida melhor com algumas dessas tarefas do que com outras. Ele é bom em fixar a versão do pacote, criar um gerador de etiquetas e um scanner, ler códigos de barras de PDFs, corrigir imagens que um leitor rejeita, e migrar de outra biblioteca de código de barras, e cada uma dessas tarefas começa com um prompt.

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 o Codex de uma árvore de trabalho limpa em um projeto de console. Declare claramente o resultado desejado, quaisquer restrições e as informações que você quer relatadas.

$ironbarcode Add the BarCode package, then update Program.cs to read a scanned
multi-page TIFF and report every barcode it finds, page by page. Each line of output
should give the page number, the decoded value and the format. Use the license
key from IRONBARCODE_LICENSE_KEY.

Constraints: Use only documented IronBarcode APIs. Do not modify or use any
other packages.

Build the project, resolve any errors, and provide the diff alongside the
output from a sample file.
Text

Uma solução correta é curta, porque BarcodeReader.Read percorre os quadros de um TIFF multipágina ou GIF animado por conta própria, sem separação manual de quadros. Configurar ExpectMultipleBarcodes ajuda quando um único quadro contém vários símbolos, mas o leitor alcança cada quadro de qualquer maneira. O prompt é mais longo do que o código resultante, e solicitar o diff desde o início permite revisar as mudanças reais em vez de uma descrição. Cada resultado carrega um PageNumber baseado em 1, que fornece a saída página por página que o prompt solicita, e o guia de GIF e TIFF multipágina cobre a leitura.



Como o Codex se encaixa em um projeto de código de barras .NET?

Dentro das permissões que você fornece, o Codex lê e escreve arquivos, executa comandos de shell, e mostra o que fez. A OpenAI disponibiliza o mesmo agente por meio de vários pontos de entrada que compartilham sua conta e histórico. A documentação da CLI do Codex e a documentação da extensão para IDE explicam como elas diferem.

InterfaceOnde é executadoQuando usar
CLITerminalO agente deve ficar ao lado de dotnet build
Extensão de IDEVS Code, JetBrains, XcodeVocê quer o diff e a imagem do código de barras lado a lado
Aplicativo de desktopmacOS, WindowsUma tarefa mais longa, fora do terminal
NuvemNavegadorPara delegar uma tarefa e obter o diff mais tarde

Um AGENTS.md cobre as quatro interfaces, porque é versionado no repositório em vez de vinculado a uma interface.

Para instalar a CLI, execute npm install -g @openai/codex ou, no macOS, brew install --cask codex. Para macOS e Linux, um instalador independente está disponível que não requer Node.js: curl -fsSL https://chatgpt.com/codex/install.sh | sh. O repositório da CLI do Codex contém o código-fonte e notas de versão.

Por favor, note: Inclua o escopo @openai/ ao instalar. O pacote npm chamado codex é um gerador de sites estáticos não relacionado, publicado pela primeira vez em 2011 e atualizado pela última vez em 2012. IronBarcode tem a armadilha oposta, porque seu pacote NuGet é BarCode, não IronBarcode. Nomes de pacotes exatos são importantes quando um agente é quem digita o comando.

Codex não conhece confiavelmente a API atual do IronBarcode. Ele trabalha a partir dos seus dados de treinamento e qualquer documentação que você fornecer, e chamar um método que uma versão posterior removeu é uma falha comum com bibliotecas de terceiros. A OpenAI constrói o Codex para executar comandos e verificar sua saída, ainda assim aconselha revisar o trabalho antes da liberação. O guia principal lista a documentação a fornecer a qualquer uma dessas ferramentas antes de começar. Troque o nome do arquivo de contexto e a mesma configuração se aplica a Claude Code, GitHub Copilot, Cursor ou Google Antigravity.

O nível muda a forma do código, bem como a conta. Um prompt executado em dois níveis retorna estruturado de duas maneiras diferentes, ambas defensáveis. A codificação de código de barras tem que ser o oposto, porque um valor entra e um símbolo sai que todo scanner lê de forma idêntica. Então, declare a simbologia, o tamanho e a condição de aprovação, e deixe o resto variar.

Quatro coisas seguem disso, e todas argumentam a favor de uma biblioteca com manutenção em vez de uma criada por um agente:

  • A validação funciona em ambos os lados: um valor inválido é recusado no momento da gravação com uma exceção nomeada como IronBarCodeFormatOnlyAcceptsNumericValuesEncodingException, enquanto ConfidenceThreshold e RemoveFalsePositive descartam decodificações não confiáveis na volta.
  • Escaneamentos reais são a parte difícil: fotos de telefones, etiquetas inclinadas e PDFs multipágina precisam de regiões de corte, predefinições de velocidade e filtros de imagem, todos disponíveis em BarcodeReaderOptions.
  • Uma API cobre os formatos: Code 128, GS1-128, EAN, UPC, QR, DataMatrix, PDF417, Aztec, MaxiCode, e mais compartilham as mesmas chamadas de leitura e escrita, listadas na íntegra em Formatos de Código de Barras Suportados.
  • Há responsáveis pelas correções: projetos de código de barras populares e gratuitos ficam sem manutenção enquanto uma biblioteca comercial tem alguém responsável, com correções publicadas em uma página de CVE de segurança.

Um codificador caseiro pode gerar sem restrições um valor que seu formato não permite representar, e qualquer biblioteca decodifica uma imagem gerada limpa. Verify é o que separa os dois, decodificando uma imagem gerada e comparando-a com o valor que você escreveu.

O que torna um prompt IronBarcode eficaz?

Respostas específicas a seis perguntas. Prompts vagos produzem código genérico destinado a uma biblioteca que não existe, e prompts específicos rendem código que você pode revisar em meio minuto.

ComponenteFracoForte
FrameworkFaça um código de barrasC#, .NET 9
LocalizaçãoNão declaradoServices/LabelService.cs
VersãoNão declaradoA versão do BarCode no .csproj
SimbologiaUm código de barrasCode 128, o número de rastreamento
SaídaUm código de barras bonitoPNG 400x120, valor abaixo, lê de volta de forma idêntica
LimitesNenhumSem novos pacotes. Leituras assíncronas. Pergunte se estiver em dúvida.

Os modelos de linguagem tendem a produzir uma resposta em vez de admitir incerteza. Informe o agente que relatar incerteza é um resultado aceitável, e ele inventa menos APIs. Dê permissão explícita para parar em vez de adivinhar.

Dicas: Use a coluna forte como uma lista de verificação. Com seis respostas em um prompt, a maioria das APIs inventadas nunca aparece.

Um AGENTS.md versionado traz benefícios para todo o projeto, porque o Codex o carrega como instruções permanentes no início de cada sessão. O arquivo raiz é lido primeiro e os arquivos aninhados depois, e o arquivo mais próximo vence, então um segundo AGENTS.md dentro de uma pasta de código de barras torna as regras mais específicas para essa pasta sem mexer no resto do repositório. /init gera um arquivo inicial se você não tiver nenhum.

Referencie a documentação legível por máquina do IronBarcode no arquivo. O arquivo llms.txt lista cada página de documentação com um resumo, e skill.md carrega os pacotes por plataforma, as regras de licenciamento, exemplos práticos e os nomes de exceção a esperar quando algo falhar.

Codex analisa .agents/skills em cada diretório do seu diretório de trabalho até a raiz do repositório, então skill.md tem um lar próprio como .agents/skills/ironbarcode/SKILL.md. O Codex compara a tarefa com o campo description do frontmatter, e você pode forçá-lo com $ironbarcode quando quiser as receitas em contexto desde o primeiro turno. A mesma pasta funciona na Antigravity, que também lê esse caminho. Peça por ambos, e pelo arquivo aninhado:

Run /init if AGENTS.md does not exist yet. Then add a Barcodes section to the
root AGENTS.md: IronBarcode (NuGet package BarCode, namespace IronBarCode) is
the only barcode library in this repository, and no competing package may be
added. https://ironsoftware.com/barcode/csharp/llms.txt gets read before any
barcode code gets written, and a member that does not appear there does not get
called. https://ironsoftware.com/barcode/csharp/skill.md belongs in
.agents/skills/ironbarcode/SKILL.md. The license key is read from the
IRONBARCODE_LICENSE_KEY environment variable and is never inlined.

Then add a second AGENTS.md under Services/ that narrows this to the reader
options this folder relies on, so the nested file wins there. Show me both files
as a diff before you commit anything.
Text

Como você pede ao Codex para adicionar IronBarcode e escrever um primeiro código de barras?

Deixe o agente lidar com a configuração primeiro. Erros de versão e nome dos pacotes começam aí.

This project needs IronBarcode. Pull in the BarCode package, then show me the
resulting PackageReference line from the .csproj and tell me which version was
installed. Do not change any other package references.
Text

Espere um diff de uma linha e a versão que foi instalada. Esse número vale a pena mencionar em prompts posteriores, e expõe um agente que adicionou um pacote diferente com código de barras em seu nome. Para fixar uma versão específica, consulte o changelog do IronBarcode.

IronBarcode não tem modo de marca d'água. Passado o período de desenvolvimento, uma chamada não licenciada falha imediatamente com LicensingException. Defina a chave na inicialização, antes de qualquer outra chamada do IronBarcode, e deixe o Codex adicioná-la.

Wire up licensing. Nothing else in IronBarcode may run ahead of it, so it goes
wherever this project does its startup work, pulling the value out of
IRONBARCODE_LICENSE_KEY rather than carrying a key in source.

Prove it took by checking IronBarCode.License.IsLicensed, and tell me which file
you put the call in.
Text

A documentação das Chaves de Licença do IronBarcode cobre chaves de teste e todas as outras opções de licenciamento, incluindo Web.config e appsettings.json.

Em seguida, construa um serviço de etiquetas e um scanner. Nos sistemas reais, os códigos de barras são criados em um lugar e lidos em outro.

Two files, one job. Shipping labels go out as Code 128 PNGs at 400 by 120
with the tracking number printed under the bars, and something on the receiving
end has to turn that image back into the tracking number.

Put the writer in Services/ShippingLabelBarcode.cs and the reader in
Services/TrackingScanner.cs. The read is async and returns null rather than
throwing when the image holds nothing.

Compile, clear the errors, and report back with the changed files and whichever
BarCode version the restore resolved to.
Text

Confira cada membro do diff na referência de API antes de aceitá-lo. Um gerador correto usa BarcodeWriter.CreateBarcode, ResizeTo, AddBarcodeValueTextBelowBarcode, SetMargins, e ToPngBinaryData, e um leitor correto usa BarcodeReaderOptions e BarcodeReader.ReadAsync, com ExpectBarcodeTypes nomeando a simbologia para que o leitor pare de buscar em cada formato. Para imagens de câmeras ou scanners, fora do contexto desse serviço, o guia de correção de imagens explica os filtros que resgatam escaneamentos fracos.

Como migrar uma implementação de código de barras existente para IronBarcode?

O trabalho de migração é repetitivo e mecânico, que é o que os agentes fazem bem. Aponte o prompt para o código real, em vez de resumi-lo.

Hand this to the explorer agent, because nothing here should be written yet.
Labels/LegacyBarcodeService.cs currently writes and reads barcodes with another
library.

1. List every symbology it writes and reads, with the options it sets
   (size, margins, text, check digits, error correction).
2. Map each call to its IronBarcode equivalent, citing the documentation page.
3. Do not write any code yet. Wait for my approval on the plan.
Text

Uma implementação de 400 linhas exige uma análise linha por linha, enquanto um erro em uma tabela de mapeamento custa uma única correção e nenhum código descartado.

Por favor, note: O planejamento primeiro adiciona uma troca, e o poupa de revisar uma diferença que você nunca aprovou.

Depois que você aprova o plano, o próximo prompt permanece bem delimitado.

Put the worker agent on the approved plan. Rewrite LegacyBarcodeService.cs to
use IronBarcode, keeping the existing public method signatures so callers do
not change.
Before removing the old library, generate every symbology the service
supports with both implementations and confirm IronBarcode reads back the
same values. Leave the old library in Git history only. Build and report the diff.
Text

Declare no prompt que as assinaturas de métodos públicos não devem mudar. Sem essa instrução, um agente frequentemente redesenhará como os chamadores usam o serviço, o que transforma uma migração em um refatoramento. Gerar cada simbologia com ambas as implementações e comparar os valores decodificados lhe dá um teste de regressão, e isso custa um ciclo extra de compilação e execução.

Como usar prompts para corrigir falhas na leitura de imagens digitalizadas?

Uma leitura falha é um problema visual, e o agente não tem visão da câmera. Seu prompt deve descrever o problema, ou melhor, incluir as imagens.

TrackingScanner finds nothing in TestData/warehouse/, yet a warehouse operator
can point a handheld at the same printed label and get a read. The photos are
shot at an angle and a few are soft. I have attached one of the failing photos
with `codex -i`, so look at it rather than reasoning from the file names.

Read TrackingScanner.cs and a sample of the images. Explain the likely cause
before changing anything, then adjust BarcodeReaderOptions only (speed, crop
area, image filters). Do not change ShippingLabelBarcode.cs. Report how many
images read before and after.
Text

Declarar o sintoma e nomear o único arquivo para editar mantém a correção contida. Uma contagem antes e depois substitui a vaga sensação de melhoria por um número. A correção é geralmente uma das três: Speed elevado a Detailed, um CropArea desenhado ao redor da etiqueta ou um único filtro de imagem escolhido para o defeito real. Empilhar filtros piora a precisão, não melhora. Os detalhes estão nas páginas de velocidade de leitura e região de corte.

Falsos positivos são o problema inverso. Lide com eles da mesma forma.

ScanService occasionally returns a value from product photos that contain no
barcode. Set RemoveFalsePositive and a ConfidenceThreshold on the reader options,
then link me to the documentation page you used.
Text

O link da documentação funciona como uma verificação. Um agente que não pode citar uma página real para a API que escolheu o alerta antes que o build o faça. As opções de leitor são fáceis de inventar, então mantenha o guia de falsos positivos por perto.

Como você depura uma falha de código de barras de ponta a ponta?

Cada prompt anterior cobre uma tarefa. Codex faz mais quando você lhe entrega um sintoma e permite que ele inspecione, diagnostique, corrija e teste por conta própria.

Switch to Sol with /model before you start, because this one has resisted the
cheaper tiers. DataMatrix labels with non-English product names are refused by
some of our older handheld scanners, while labels with plain ASCII names read
fine on the same devices, and every label reads correctly with IronBarcode
itself.

Investigate:
1. Read LabelService.cs and find how the DataMatrix codes are created.
2. Identify why the non-English labels fail on those scanners only.
3. Explain the cause before changing anything.
4. Then propose the minimal fix, and what it costs, before applying it.
Text

Pedir a causa primeiro lhe dá um diagnóstico para julgar, em vez de uma edição para decodificar depois. Aqui, a causa provável é o cabeçalho UTF-8 ECI. IronBarcode escreve esse cabeçalho apenas quando o texto contém caracteres não ASCII, e scanners construídos antes da existência do ECI rejeitam um símbolo que o possua. Desativar o cabeçalho quebra o texto UTF-8 nos scanners que suportam ECI, então o trade-off é real. A versão 2026.9.2 adicionou EciMode para controlá-lo, conforme descrito no guia de codificação ECI.

Trate mensagens de erro da mesma forma. Um rastreamento de pilha completo é a entrada mais útil que você pode fornecer a um agente.

TrackingScanner.ReadTrackingNumberAsync throws inside our Linux container. The
identical call succeeds on a Windows developer machine.

[PASTE FULL EXCEPTION AND STACK TRACE HERE]

Send the explorer subagent over the .csproj and the Dockerfile before changing
anything, and tell me which BarCode package we actually reference and what the
image is missing, quoting the line from each file that shows it.

Then give me the fix as a diff limited to those two files. Application code is
out of scope for this one.
Text

Falhas dentro de contêineres geralmente vêm do pacote da plataforma ou de uma dependência nativa ausente. Essas correções pertencem ao arquivo do projeto e ao Dockerfile, não ao C#. Deixe Codex ler Executar IronBarcode no Docker no Linux para orientação de implementação atual antes de mudar qualquer coisa.

Como transformar código pontual em componentes reutilizáveis e testados?

Quando o ciclo de geração e leitura funciona, generalize-o em seguida. Os agentes lidam bem com isso porque o padrão já existe no arquivo.

Refactor ShippingLabelBarcode and TrackingScanner into a BarcodeService
registered with dependency injection. It should write any of Code 128, QR,
and DataMatrix, and read with options narrowed to the formats requested.
Reuse one BarcodeReaderOptions instance per format set rather than building
one per call. Add XML doc comments. Keep it under 80 lines.
Text

A instrução para reutilizar opções pertence ao AGENTS.md. Em um serviço de digitalização com alto volume de uso, construir um novo objeto de opções por solicitação é uma alocação que você paga em cada digitalização.

Os testes vêm a seguir. Um código de barras ou decodifica de volta para o valor que você escreveu ou não, o que mantém as asserções simples.

This is a rebuild-and-rerun loop rather than a reasoning problem, so drop to
Luna with /model first. Cover BarcodeService with xUnit tests, then run them and
tell me the pass count.

Four behaviors need covering. A sample value survives a write and a read on
every format the service supports. EAN-13 rejects a value containing letters.
An image holding no barcode comes back empty instead of throwing. A path that
does not exist throws something a caller can read.

Never assert on image bytes. Decoded value and format are the only outputs
worth pinning.
Text

Evitar comparações de bytes desde o início evita testes não confiáveis. Os codificadores podem produzir bytes de imagem ligeiramente diferentes entre versões e plataformas, mesmo que o código de barras permaneça inalterado. Em vez disso, teste o valor decodificado e o formato.

Codex também é útil para ler a documentação em si. Ao indicar uma classe desconhecida, aponte a parte relevante da referência de API em vez de deixá-lo rolar a página inteira.

$ironbarcode Read the IronBarcode API reference for BarcodeReaderOptions and
list every option that affects reading speed or accuracy, then show which ones
this project already sets.
Text

Qual padrão de prompt se encaixa em qual tarefa?

Cada prompt acima nomeia algo concreto e pede algo verificável em troca.

TarefaO que especificar no promptO que pedir em retorno
PacoteBarCode, a versão, nada maisA linha PackageReference
Chave de licençaIRONBARCODE_LICENSE_KEY, caminho de inicializaçãoLicense.IsLicensed verdadeiro
Escritor e leitorSimbologia, ambos os caminhos, tamanho da imagemDois arquivos que compilam
MigraçãoArquivo legado, assinaturas para manterUma tabela de mapeamento, antes do código
Escaneamentos falhosPasta de imagens, somente opções de leitorContagem de leitura antes e depois
Falsos positivosRemoveFalsePositive, ConfidenceThresholdA página que citou
Falha de contêinerRastreamento da pilha, plataforma, dois arquivosUm diff, .csproj e Dockerfile
RefatorarFormatos, estrutura de injeção de dependência, limite de linhasUma instância de opções por formato
TestesQuatro comportamentos, sem asserções sobre bytesO número de testes aprovados

Como você reutiliza esses prompts no próximo projeto?

Cada padrão se move para um novo projeto com apenas os nomes dos arquivos alterados, é por isso que as regras pertencem ao controle de versão e não a um histórico de chat.

Para medir uma sessão em vez de confiar nela, o guia de assistentes de codificação e agentes de IA entrega uma tarefa a um agente e pontua o que volta.


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