IronBarcode 작업을 Claude Code에 위임하기
바코드 작업의 성공 여부는 세 가지 조건에 따라 결정됩니다. NuGet 패키지는 BarCode, 라이선스 키는 환경에서 가져오며, 이미지를 디코딩하고 생성에 사용한 값과 비교하기 전까지 작업이 완료되지 않습니다. Claude Code는 이러한 사실들을 프롬프트가 아닌 저장소에 유지하는 이 시리즈의 도구입니다. 매 대화의 시작에서 CLAUDE.md를 읽고, 작업이 바코드 코드를 다루면 .claude/skills/ironbarcode/SKILL.md를 로드합니다. 이 위치는 IronBarcode가 공개한 skill.md를 저장하도록 마련된 곳입니다.
어떤 모델이 읽더라도 이 규칙은 동일하게 적용되며, 모델 선택은 비용을 조절하는 주요 수단입니다. /model sonnet 옵션은 레이블 서비스 연결 및 테스트 세트 실행과 같은 대부분의 바코드 작업에 충분합니다. 복잡한 마이그레이션에서 코드 매핑이 중요한 경우, Opus를 계획에 사용하고 Sonnet을 구현에 사용하는 /model opusplan 옵션이 유리합니다. Fable 5.1로 해석되는 fable 별칭과 간단한 작업용 haiku 별칭도 사용할 수 있으며, 세션 중에 모델을 전환할 수 있습니다.
하나의 패키지로 전체 작업을 처리할 수 있다는 점은 사람보다 에이전트에게 더 중요합니다. 1D 및 2D 쓰기, 하나의 이미지에서 여러 바코드 읽기, 멀티스레드 읽기는 모두 같은 API에서 제공되어, 에이전트가 작업 도중 다른 라이브러리를 추가하기 위해 승인을 요청하며 멈출 필요가 없습니다. 이미지를 막 작성한 후 GeneratedBarcode.Verify가 그것을 디코딩하고 값을 비교하므로 왕복 과정을 작업 자체에 통합하십시오.
선택한 티어는 생성된 코드와 비용 모두에 영향을 미칩니다. 동일한 프롬프트를 다른 모델에 제공하면 클래스 이름, 옵션 레이아웃, 테스트 구조를 포함한 고유한 구현이 나타납니다. 일관된 출력을 위해 인코딩, 픽셀 크기, 성공적인 읽기로 간주할 것을 고정하고, 나머지는 모델이 선택하도록 하십시오.
빠른 시작.NET 프로젝트에서 세션을 시작하고 구현 세부사항보다 요구 사항에 초점을 맞추어 원하는 바코드를 지정하십시오.
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.
Claude Code는 나머지 단계를 완료합니다: 패키지를 추가하고 비동기 읽기를 연결하며 프로젝트를 빌드하고 컴파일 오류를 해결하며 결과를 보고합니다. 코드 변경 내용과 측정된 시간을 검토합니다. 비동기 및 멀티스레드 가이드는 에이전트가 사용해야 할 옵션을 설명합니다.
명시되지 않은 모든 세부 사항은 자동으로 결정됩니다. 간단한 예에서는 문제가 없으며 최신 패키지와 기본 설정이 사용됩니다. 프로덕션 작업에서는 다음 세 가지 제한을 프롬프트에 설정하십시오:
- 버전 지정: 에이전트가 단일 API 표면에 대해 코드를 작성하도록 IronBarcode 릴리스를 지정하십시오.
- 종속성 제한: 다른 바코드 라이브러리가 추가되지 않도록
BarCode패키지만 허용하십시오. - 에이전트가 멈추도록 허용: 문서화된 API만 사용하고 불확실한 경우 이를 알리도록 지시하십시오.
5단계 기본 워크플로
- NuGet에서 C# 바코드 라이브러리 다운로드
- 프로젝트 루트에서 Claude Code 세션을 시작하여 에이전트가 기존 코드베이스에 접근할 수 있도록 하십시오.
- 제한 사항을 각 세션에 적용되도록
CLAUDE.md에 문서화하십시오. - 프롬프트에 심볼로지, 입력 값, 예상 읽기 결과를 포함하십시오.
- 프로젝트를 빌드하고 왕복을 실행하며 API 참조에 대해 각 API 이름을 검증하십시오.
어떤 바코드 작업을 넘겨야 할까요?
Claude Code는 주로 반복적인 개발 작업을 처리합니다. 코드를 읽고 작성하고 리팩터링하며, 빌드를 실행하고 어떤 인터페이스에서든 테스트를 반복 실행합니다. 바코드 생성과 스캔도 별도의 설정 없이 이 과정에 포함할 수 있습니다.
바코드 작업의 경우, Claude Code는 레이블 서비스 작성, 스캔 엔드포인트 생성, 필요한 형식으로 테스트 이미지 생성 및 읽기 등의 반복 작업을 관리합니다. 유효하지 않은 EAN-13 체크 디지트 등을 감지하고 수정하며 필요에 따라 다시 빌드하고 오류 발생 시 재시도합니다. 바코드 사양을 제공하고 결과 코드 변경을 검토합니다.
바코드 라이브러리 선택은 여전히 개발자의 책임입니다. 지정하지 않으면 에이전트는 학습 데이터에서 가장 자주 본 라이브러리를 기본으로 선택하며, 이로 인해 네 가지 문제가 발생합니다:
- 심볼 크기 및 체크 디지트: 축소된 심볼, 누락된 여백 영역 또는 잘못된 숫자는 올바르게 보일 수 있으나 스캐닝 중 실패할 수 있으며, IronBarcode는 작성 시 각 심볼로지에 대한 값을 검증합니다.
- 토큰 용량이 과금 결정: 에이전트가 자체 디코더를 구현하면 매 작업마다 토큰 비용이 발생합니다. 반면 멀티스레드 읽기, 속도 프리셋, 이미지 필터는 이미 최적화되고 문서화되어 제공됩니다.
- 검증 없는 맞춤 파이프라인: 대용량 데이터세트나 게시된 벤치마크에 대해 테스트되지 않았으며, 반복 가능한 왕복 테스트가 포함된 문서화된 API와 다릅니다.
- 패키지 이름이 보안 제어로 작동함:
dotnet add package IronBarcode는 IronBarcode를 설치하지 않고, 유사한 이름이 악의적인 행위자에 의해 등록되었습니다.
에이전트가 추측할 필요가 없도록 프롬프트에서 BarCode를 지정하십시오.
패키지 이름을 지정해 두면 이후 작업에서는 라이브러리를 다시 선택할 필요가 없습니다.
새 설치에서 첫 바코드 프롬프트로 이동하기 위한 단계는 무엇입니까?
응용 프로그램을 설치하고 Claude 계정으로 로그인하면 준비가 완료됩니다. Anthropic의 Claude Code 개요는 이 도구에 대한 자세한 설명을 제공합니다. 빠른 시작 가이드는 macOS, Windows, Linux에서의 설치 및 첫 세션을 다루며, IDE를 선호하는 사용자를 위한 VS Code 및 JetBrains 확장에 대한 별도의 페이지가 있습니다. Anthropic의 YouTube 채널도 첫 세션에 대한 비디오 워크스루를 제공합니다.
claude를 실행하고 정상적으로 응답하는 것을 확인한 후 이 가이드를 계속 진행하십시오.
Claude Code가 사용할 수 있는 프로젝트를 설정하는 방법은 무엇입니까?
일반적인 .NET 프로젝트를 만들고 IronBarcode를 추가한 후 에이전트로 열어보십시오. 프로젝트가 미리 정상적으로 빌드되는지 확인하면 혼란을 줄이고 에이전트가 사용할 바코드 라이브러리나 유사한 이름의 패키지를 추측하지 않도록 방지합니다.
dotnet new console -n LabelScanDemo
cd LabelScanDemo
dotnet add package BarCode --version 2026.9.2
claude
마지막 명령은 현재 폴더에서 세션을 열며, 그 디렉토리로 에이전트의 읽기 및 편집을 제한합니다. Anthropic의 문서는 이 접근 방식을 추천합니다. CLI를 실행하기 전에 프로젝트 디렉토리로 이동하십시오. 터미널, IDE 확장, 데스크톱 앱 및 웹을 포함한 모든 인터페이스는 동일한 엔진을 사용합니다. 그 결과, CLAUDE.md 파일, 프로젝트 설정, 프로젝트에 설정된 MCP 서버는 세션 전반에서 일관성을 유지합니다.
두 가지 추가 세부 사항은 나중에 유익할 것입니다:
CLAUDE.md: 각 세션 시작 시 Claude Code가 로드하는 지침 파일, 대상 프레임워크 지정,BarCode패키지 지정, 문서화된 API만 허용된다는 규칙을 기재합니다.- IronBarcode 문서 색인:
llms.txt은 에이전트가 구문 분석할 수 있는 형식으로 실제 문서 URL을 나열하고,skill.md는 일반적인 실패에 대해 검증된 레시피 및 수정 내용을 추가합니다.
Claude Code는 저장소의 .claude/skills/<name>/SKILL.md 에서 스킬을 읽습니다. IronBarcode 파일을 .claude/skills/ironbarcode/SKILL.md로 저장하고 커밋하십시오. 이 방식은 프런트매터의 description만 컨텍스트에 유지하며 관련 작업이 발생할 때 Claude가 본문을 로드합니다. 이 접근 방식은 바코드 작업 시작 전까지 오버헤드를 최소화합니다. 더 세분화하려면, 에이전트가 필요한 파일에 접근할 때만 스킬을 로드하도록 paths에 Services/**와 같은 글로브 패턴을 추가하십시오.
두 파일이 모두 설치되면, 에이전트는 메모리에 의존하기보다는 문서를 참조하게 됩니다. 하나의 프롬프트로 필요한 파일을 생성할 수 있습니다.
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.
첫 실행 전에 라이선스를 설정하십시오, IronBarcode가 개발 유예 기간이 끝나면 워터마크를 추가하기보다는 LicensingException를 발생시킵니다. 바코드를 다루기 전에 조기에 환경에서 키를 가져옵니다. IronBarcode 라이선스 키 문서는 키를 얻고 적용하는 방법을 설명합니다.
컴파일되는 IronBarcode 코드를 요청하려면 어떻게 해야 합니까?
그대로 두면 에이전트가 추측하게 될 세 가지 요소를 지정하십시오: 심볼로지, 값의 출처, 성공 기준.
프롬프트를 사양으로 작성하십시오.
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.
이 프롬프트에서는 세 가지 요소가 중요합니다:
- 파일 경로: 프롬프트에서 경로를 지정하면 에이전트가 임의로 구조를 만드는 대신 쉽게 탐색할 수 있는 프로젝트 구조를 따릅니다.
- 양쪽의 심볼로지: 생성과 읽기 모두 Code 128을 사용하므로 리더가 형식을 추측할 필요가 없습니다.
- 왕복으로 정의된 완료: 에이전트는 생성에 사용한 값과 읽힌 값을 대조하여 바코드의 모양을 확인하는 것보다 나은 결과를 냅니다.
CLAUDE.md에 대한 제약을 복사하도록 지시하십시오. 미래 세션에서는 이러한 제약 조건이 자동으로 로드됩니다.결과는 짧아야 합니다. 그것은 BarcodeWriter.CreateBarcode와 BarcodeEncoding.Code128을 사용한 후, ResizeTo, AddBarcodeValueTextBelowBarcode, SetMargins으로 레이블 크기를 조정하고, 값을 인쇄하며, 여백 영역을 추가합니다. 바이트는 ToPngBinaryData로 생성되며, ExpectBarcodeTypes가 Code 128로 설정된 상태로 BarcodeReader.ReadAsync가 그것들을 읽습니다. 생성된 파일 대신 실제 스캔의 경우, Speed, CropArea, 이미지 필터와 같은 옵션이 훨씬 더 중요해집니다. 바코드 리더 튜토리얼은 그것들을 다룹니다.
Claude Code가 MCP를 통해 IronBarcode에 연결할 수 있나요?
Claude Code는 개방형 표준인 모델 컨텍스트 프로토콜(MCP)을 통해 외부 도구와 통합됩니다. MCP 서버는 모델이 트레이닝 중에 보지 못한 도구, 데이터베이스, API를 표시할 수 있으며, MCP 참조에 나타난 대로 하나의 CLI 명령으로 서버를 추가할 수 있습니다.
IronBarcode는 서버가 필요 없습니다. 통합에 필요한 것은 세 개의 URL로 제공되는 문서입니다. llms.txt는 문서를 색인합니다. skill.md 파일은 검증된 레시피와 일반적인 실패를 보유합니다. API 참조는 릴리스의 모든 클래스와 멤버를 나열합니다. 이 문서들을 읽으면 에이전트는 기억된 API가 아닌 현재 사실을 알게 되며, 이는 MCP 서버가 흔히 해결하는 오래된 메서드 정보 문제와 같습니다. 실행할 프로세스가 없고, 유지할 구성도 없으며, 문서가 업데이트될 때 다시 시작할 필요도 없습니다. 에이전트는 세션 동안 페이지를 간단히 가져옵니다.
세 가지 소스를 프로젝트 컨텍스트에 추가하여, 그 안에 붙여넣거나 CLAUDE.md에서 참조하십시오. 그 세션의 모든 프롬프트는 이를 활용할 수 있습니다.
생성된 바코드 코드를 신뢰하기 전에 무엇을 확인해야 합니까?
모든 API 이름과 바코드를 검증하십시오. 앞 단계일수록 확인 비용이 적으므로 다음 네 단계를 순서대로 수행하십시오:
- 빌드가 통과되었습니다: 존재하지 않는 멤버를 몇 초 안에 찾아낼 수 있으므로 diff를 검토하기 전에
dotnet build를 실행하십시오. - 각 멤버가 존재합니다: 인코딩 열거형이
Databar및DataBar에서 한 글자의 대소문자로 구별되는 경우, 인식하지 못하는 모든 클래스 및 메서드는 API 참조를 검색하여 두 번 확인하십시오. - 모든 바코드는 다시 스캔됩니다:
GeneratedBarcode.Verify는 한 번의 호출로 그것을 해결하며, 저장된 파일을BarcodeReader로 읽으면 디스크에 도달한 것에 대해 동일한 것을 증명합니다. - 오류 처리가 마련되었습니다: 생성된 코드는
BarcodeReader.Read가 항상 바코드를 찾는다고 가정하고,LicensingException, 손상된 파일에 대한IronBarCodeFileException, 암호화된 PDF에 대한IronBarCodePdfPasswordException, 경로 누락 시 발생하는 일반적인System.IO.FileNotFoundException을 간과하는 경향이 있습니다.
잘못된 체크 디지트는 완벽하게 컴파일되며, 아무 것도 찾지 못한 읽기는 빈 BarcodeResults 컬렉션을 반환하며 예외를 발생시키지 않습니다. 후속 프롬프트에서 그 처리를 요청하고 오류 처리 가이드를 에이전트에게 알려줍니다.
에이전트가 BarcodeScanner.DecodeImageFile()을 작성하면, IronBarcode에 없는 그럴듯한 메서드 이름을 생성한 것입니다. 컴파일러는 즉시 그것을 거부하므로, 조기에 자주 빌드하십시오.
미리 알아야 할 실질적인 한계는 무엇입니까?
특정 바코드 작업은 다른 것보다 에이전트에 더 적합합니다.
| 작업 | 적합 | 왜 |
|---|---|---|
| 바코드 생성 | 높음 | 다시 읽어 검증 가능 |
| 왕복 테스트 | 높음 | 문자열 일치 여부로 통과 판단 |
| 서비스 연결 | 높음 | 반복되는 패턴 |
| 실제 스캔 조정 | 상황에 따라 다름 | 에이전트가 볼 수 없는 결함 |
| 라이선스 및 배포 | 낮음 | 개발자의 키와 플랫폼에 따라 달라짐 |
바코드를 다시 읽어 확인할 수 있는 작업이라면, 에이전트가 잘 수행합니다. 보이지 않는 이미지나 특정 배포 대상에 의존한다면, 더 많은 확인이 필요합니다. Claude Code에게 생성, 연결, 왕복 테스트를 직접 맡기십시오. 라이선스, 플랫폼 패키지 또는 실데이터 스캔 조정에 대해서는 샘플 이미지나 문서 링크를 요청에 첨부하십시오.
남아있는 결정은 무엇입니까?
Claude Code는 서비스를 생성하고 테스트 데이터를 생성하며, 필요에 따라 반복합니다. 라이브러리를 선택하고 API 이름을 검증하는 것은 여전히 개발자의 책임입니다.
세션을 종료하기 전에 결정 사항을 CLAUDE.md에 기록하여 다음 세션에서 이어서 작업할 수 있도록 하십시오. 빈 프로젝트에서 명시된 통과 기준을 충족하기까지의 작업 과정은 AI 코딩 어시스턴트 및 에이전트 가이드에 기록되어 있으며, ChatGPT Codex, GitHub Copilot, Cursor, Google Antigravity 가이드와 함께 제공됩니다.
문제 해결
- 라이선스 라인에서 에이전트의 첫 실행이 멈추면 IronBarcode에 라이선스 키 적용 가이드를 참조하십시오.
- 왕복이 심볼을 쓰지만 읽을 수 없을 때 바코드 인식 안 됨 가이드를 참조하십시오.
CLAUDE.md에서 패키지 이름을 지정하기 전에 IronBarcode NuGet 패키지를 참조하십시오.
질문?
질문이 있으시면 support@ironsoftware.com으로 문의하세요.
커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.