IronZIP를 Claude Code와 함께 사용하는 방법
업데이트를 거친 사례 보관 파일은 올바른 비밀번호로 열 수 있으며 모든 파일을 나열하고 말끔하게 추출할 수 있지만, 여전히 AES-256 대신 구식 ZIP 암호를 유지합니다. 파일 목록에는 변화가 나타나지 않습니다. Claude Code는 Anthropic의 코딩 에이전트로, 명령줄, VS Code 및 JetBrains IDE, 데스크톱 앱 및 브라우저에서 사용할 수 있습니다. 이 프로그램이 실행되는 곳 어디에서든지 리포지토리를 읽고, 파일을 편집하며, 셸 명령을 실행하여 업데이트된 아카이브를 준비하고, 추출하여 원본이 교체되기 전에 디렉토리를 읽고 모든 파일을 비교합니다.
IronZIP는 .NET에서 AES-128, AES-256 또는 ZipCrypto로 알려진 구식 전통 암호로 암호화된 ZIP 파일을 열고 편집하고 저장합니다. 각 편집은 한 번의 호출로 이루어집니다. 아카이브를 여는 호출, 교정된 파일이 이전 항목을 어떻게 대체하는지, 그리고 저장 전 재암호화 설정 여부가 결과를 결정합니다. 각 단계에서 잘못된 선택을 해도 예외는 발생하지 않습니다. 이 페이지의 나머지 부분은 Claude Code를 매달 증거를 받기 위해 준비하며, 4개의 테스트 질문과 각 질문 뒤에 있는 IronZIP 동작을 포함합니다.
두 가지 모델 설정이 세션을 다룹니다. Sonnet은 나열 및 프로젝트 규칙을 처리하고, opusplan 별칭은 Opus와 함께 업데이트 계획을 세우고 Sonnet으로 그것을 작성합니다.
빠른 시작리포지토리 폴더에서 claude을 실행하고 이 요청 전에 /model sonnet을 실행하십시오.
Add the IronZIP NuGet package, version 2026.10.2, to CaseArchive.csproj.
Then make Program.cs list every ZIP file under archives/:
- Apply the license key from IRONZIP_LICENSE_KEY before any other IronZIP call.
- Open each file as an IronZipArchive with the password from CASE_ARCHIVE_PASSWORD.
- Print a block per archive with its entry count, then each entry's name, size and IsCrypted value.
- If an archive won't open, print its exception message and move on to the next one.
Don't change any archive.
Don't print or echo the value of either variable. Tell me whether each one is set.
CASE-1043는 올바른 비밀번호가 있어도 실패할 수 있습니다. 기존 ZIP을 여는 섹션에서 그 이유를 설명합니다.
최소 워크플로우(5단계)
- NuGet에서 C# ZIP 라이브러리 다운로드
- 리포지토리에서 Claude Code를 실행하고 /model로 모델을 선택합니다.
- IronZIP의 업데이트 규칙을 CLAUDE.md에 넣고 편집할 수 없는 리뷰 서브 에이전트를 만드세요.
- 계획 모드에서 업데이터를 계획하고, 각 새 아카이브를 아카이브 폴더 밖에 준비합니다.
- 준비된 모든 아카이브를 추출하고, 파일을 비교하고, 원본을 교체하기 전에 디렉토리를 읽습니다.
.NET 아카이브 프로젝트에서 Claude Code는 무엇을 하나요?
Claude Code는 업데이터를 작성하고, 각 준비된 아카이브를 빌드하고, 그것을 풀고, 디렉토리를 읽고, 통과하지 못한 체크리스트를 나열합니다. 체크가 실패한 후에는 코드를 편집하고 전체 입력을 다시 실행합니다. 귀하의 역할은 각 사례 아카이브에 어떤 것이 들어가야 하는지 정의하고, 마지막에 보고서를 읽는 것입니다.
첫 번째 질문에서 유일한 아카이브 라이브러리로 IronZIP을 지정합니다. 공격자는 AI 코딩 도구로 인해 가짜 패키지를 게시하고, 그 자체로 패키지를 선택하는 에이전트는 그것을 설치할 수 있습니다. 이 공격은 슬롭스쿼팅이라고 불립니다.
Claude Code를 어떻게 설정하나요?
Anthropic의 빠른 시작은 Claude Code 설치와 로그인을 다룹니다. 작동하는 설치는 claude --version의 버전 번호를 출력합니다.
Claude Code가 작업할 수 있는 프로젝트를 어떻게 설정하나요?
테스트 리포지토리, CaseArchive는 아카이브 폴더에 3개의 AES-256 사례 아카이브, 2개의 새 파일을 위한 인커밍 폴더, 및 입력 규칙을 설정하는 문서 폴더에 Markdown 페이지를 보유하는 .NET 9 콘솔 프로젝트입니다. 새 파일 이름이 추가되면, 일치하는 이름이 항목을 대체하고, remove.txt에 나열된 이름은 제거되며, 인커밍 폴더가 없는 사례는 그대로 유지됩니다. 아카이브 비밀번호는 CASE_ARCHIVE_PASSWORD에서 유래됩니다.
CLAUDE.md에 작성된 규칙은 각 세션 시작 시 로드됩니다. 빠른 시작 이후 패키지가 설치된 후, 다음 요청은 그 파일과 리뷰어를 작성합니다.
Create CLAUDE.md in the repo root with a "Case archives" heading.
Put these rules under it for future sessions:
- Archives are read and written with IronZIP and nothing else.
- The IronZIP package stays at the version CaseArchive.csproj references now.
- The intake rules live in docs/case-archives.md.
- Look up an IronZIP member in docs/IronZip.xml before you use it.
- The XML has no entry for IronZip.Entry. Its Name, Size and IsCrypted exist anyway.
- A file replaces an archive under archives/ after it has passed every check, never before.
- CASE_ARCHIVE_PASSWORD and IRONZIP_LICENSE_KEY values never appear in output, logs or files.
Copy docs/IronZip.xml now from the local NuGet cache folder for that IronZIP version.
If the cache has no such file, stop and tell me.
Then create .claude/agents/archive-auditor.md.
Give it frontmatter with the name archive-auditor, a one-line description and a tools field.
The tools field lists Read, Grep and Glob, so the auditor can't edit.
In its instructions, tell it to:
- collect the IronZIP types and members used under Services/
- flag any member that docs/IronZip.xml lacks, and list Entry members separately
- point out each save of an opened archive that doesn't set the encryption again first
실행 중인 Claude Code 세션은 새로 생성된 .claude/agents 폴더를 감지하지 않으므로, 시작 전에 폴더와 그 안에 플레이스홀더 파일을 커밋하세요.
첫 번째 열기 전에 라이선스를 설정하세요. 키가 없으면 열기와 추출 모두에서 LicensingException을 던지고, 메시지는 '프로덕션 라이선스 필요'라고 표시됩니다. IRONZIP_LICENSE_KEY 변수만으로는 IronZIP에 라이선스를 부여하지 않습니다. 교정 프로브에서 변수는 설정되었으나 License.IsLicensed는 여전히 false로 유지되어, 프로그램은 여기에서 IronZip.License.LicenseKey를 할당합니다. IronZIP 라이선스 키 페이지는 키를 얻는 방법과 설정 위치를 설명합니다.
CLAUDE.md에 포함할 IronZIP 업데이트 규칙은 무엇인가요?
교정 프로브는 IronZIP 2026.10.2의 각 줄을 피처 아카이브 및 매칭 프로브 아카이브와 비교하여 측정했습니다. 블록을 Case 아카이브 제목 아래에 붙여넣고, 세션에서 읽을 수 있도록 claude --continue로 시작하세요.
Measured on IronZIP 2026.10.2, these rules apply to every archive update:
- Open with new IronZipArchive(path, password) or IronZipArchive.FromArchive(path, password).
- IronZipArchive.FromFile(path) builds a new archive that stores the ZIP file itself as one entry.
- A protected archive with exactly one entry does not open.
- The constructor and FromArchive throw "Invalid Password!" with the right password.
- ExtractArchiveToDirectory reads it, so rebuild it from an extracted copy in a new IronZipArchive.
- Saving an opened archive writes every entry with the Traditional cipher.
- Call Encrypt(password, EncryptionMethods.AES256) before the save to keep AES-256.
- Entries() reports IsCrypted true either way.
- Opening does not check the password. The save does.
- Entries() lists an archive opened with a wrong password, and SaveAs then throws ZipException.
- Add stores the file name without its folder.
- Adding a name the archive already holds keeps both entries, and extraction writes the later one.
- ReplaceEntry(name, path) stores the new entry under the path it is given, folders included.
- Replace an entry with Delete(name) and then Add(path).
- Delete and ReplaceEntry throw for a name the archive does not hold. Test Contains(name) first.
- Add throws UnauthorizedAccessException for a folder. Add files one at a time.
- Save() writes back over the file the archive was opened from.
업데이트된 아카이브에서 AES-256 암호화가 사라지는 이유는 무엇인가요?
저장 시 메서드를 다시 설정하지 않으면 전통적인 암호로 되돌아갑니다. 우리의 교정 프로브에서는 비밀번호로 CASE-1044를 열고 아무 변화 없이 저장했을 때 세 개의 항목 모두 전통적인 암호로 작성되었습니다. 그런 다음 Python 표준 zipfile 모듈은 AES 항목을 읽을 수 없으므로 비밀번호로 각각을 해독했습니다. 저장 전에 Encrypt에 EncryptionMethods.AES256을 호출하면 업데이트된 CASE-1042의 모든 다섯 개 항목, 그리고 세 개의 새 항목 모두 AES-256로 유지되었습니다. AES-256을 이름으로 지정한 ZipSaveOptions이 저장 호출에 전달되면, 하나의 항목이 삭제된 아카이브에서도 동일한 결과가 나타납니다.
비밀번호로 추출은 어떤 경우에도 성공하기 때문에, 원시 디렉토리만이 다운그레이드 현상을 보여줍니다. 각 AES 항목은 256비트 키의 강도 바이트가 3인 추가 필드 0x9901을 갖고 있으며, 프로브의 전통 항목에는 그러한 필드가 없었습니다.
IronZIP으로 기존 ZIP을 여는 방법은 무엇인가요?
경로와 비밀번호를 생성자에게 전달합니다. ZIP에 파일 추가 예제는 대신 FromFile로 아카이브를 열며, 프로브에서 CASE-1042.zip을 추가된 사진 옆에 암호화되지 않은 하나의 항목으로 보유하는 아카이브를 생성했습니다. IronZIP의 skill.md는 FromFile가 항상 새 아카이브를 생성한다고 경고하며, 생성자와 FromArchive을 하나를 여는 호출로 명명합니다.
단일 보호 항목이 있는 아카이브는 다른 방법이 필요합니다. 프로브들에서, 이러한 종류의 AES-256 아카이브는 생성자, FromArchive, 바이트 배열 생성자에서 '잘못된 비밀번호!'를 던졌으며, 동일한 비밀번호로 추출은 작동했습니다. 생성자는 하나의 항목이 있는 전통 아카이브에서도 동일한 오류를 던졌습니다. 재구성은 아카이브를 임시 폴더에 추출하고, 인커밍 파일을 복사하여 Encrypt이 먼저 호출된 새 아카이브를 저장합니다. 재구성된 CASE-1043는 세 개의 AES-256 항목을 보유했으며, 그 후 정상적으로 열렸습니다.
컴파일되는 IronZIP 코드를 유도하는 방법은 무엇인가요?
/model opusplan을 실행한 다음, Shift+Tab을 반복하여 상태 표시줄에 계획 모드가 나타날 때까지 하고 요청을 보냅니다.
Build the monthly intake in Services/IntakeUpdater.cs and Services/ArchiveCheck.cs.
Program.cs runs both after the listing.
IntakeUpdater applies @docs/case-archives.md to each case folder under incoming/:
- It writes out/staged/<case id>.zip with AES-256 and the same password.
- It leaves archives/ untouched.
- A case without an incoming folder keeps its archive byte for byte.
ArchiveCheck judges a staged archive without trusting IronZIP's listing:
1. Extract both archives with IronZIP and the password into new temp folders.
2. Compare each staged entry's SHA-256 with its source.
3. Parse the staged file's central directory bytes itself, without decrypting.
A case fails on any of these:
- a repeated entry name
- an entry without AES extra field 0x9901 at key strength 3
- staged names that differ from the expected set
An added or replaced entry's source is the incoming file.
A kept entry's source is its extracted original.
The expected set is the original names minus those in remove.txt, plus incoming names.
Leave out remove.txt itself.
Move a passing case's staged file over the original.
Use a plain file move, not a second IronZIP save.
A second intake on the same incoming files must pass and leave the same entries.
Write out/intake-report.csv with one row per case:
- entries before and after
- names added, replaced and removed
- pass or fail, with the reason
Print how many cases pass.
Only the directory parse may read an archive without IronZIP.
Don't add another package.
When all cases pass, have @agent-archive-auditor review Services/.
질문의 각 검사는 다른 잘못된 통과를 막습니다.
- 소스에 대한 해시: 교체된 항목은 인커밍 파일과 비교되므로, 이전 텍스트를 유지한 문장은 실패합니다.
- 디렉토리 파싱: 중복된 이름과 누락된 항목도 추출 시 감지되지 않습니다.
- 먼저 준비: 검사에 실패한 업데이트는 원래 아카이브를 그대로 둡니다.
Encrypt를 호출하고, 추출된 복사본에서 CASE-1043를 재구성하며, 교체된 이름을 두 번 저장할 수 없도록하는 계획을 받아들이십시오. 이는 먼저 이전 항목을 삭제하거나 각 준비된 아카이브를 새로 구축하기 때문입니다. 그 중 하나라도 빠진 계획은 여전히 맞게 나열된 아카이브를 작성합니다.잘못된 비밀번호가 사례 아카이브를 손상시킬 수 있나요?
IronZIP는 AES로 보호된 아카이브를 어떤 비밀번호로 열든지 나열하므로, 첫 번째 오류는 늦게 발생합니다. 교정 프로브에서는 저장이 ZipException("AES 비밀번호가 잘못되었습니다")를 던지고 파일을 작성하지 않았으며, 추출은 ArgumentException("잘못된 비밀번호!!")를 던졌습니다. 마지막 질문에서는 이 경로가 원본을 변경하지 않음을 에이전트가 증명해야 합니다.
Prove a wrong archive password can't damage anything, in these steps:
1. Hash every file under archives/ with SHA-256.
2. Launch the built program a second time, in a child process.
3. Hash the files again once the child exits.
4. Print both hash lists side by side.
5. Print the child's exit code and the failure reasons it wrote to out/intake-report.csv.
The child inherits IRONZIP_LICENSE_KEY and gets a wrong CASE_ARCHIVE_PASSWORD.
It also gets a --child flag, under which it starts no process.
Three things have to hold:
- Every hash matches.
- The report has a failed row for CASE-1042 and one for CASE-1043, each with IronZIP's error text.
- The exit code is non-zero.
Change the program only where one of those fails, then run the check again.
실제 실행에서 프롬프트가 무엇을 생성했습니까?
Claude Code는 단일 세션 내에서 네 개의 질문을 차례로 받았고, 규칙 블록은 세 번째 질문 전에 CLAUDE.md에 추가되었습니다. 실행 후, 커밋된 코드는 깨끗한 복제본에서 재구성되고 원본 아카이브와 비교하여 실행되었습니다. IronZIP과 코드를 공유하지 않는 Python 라이브러리 pyzipper는 모든 결과를 읽었습니다.
- Claude Code가 자체적으로 실행한 빠른 시작 목록은 CASE-1042에 4개의 암호화된 항목, CASE-1044에 3개, CASE-1043에는 "잘못된 비밀번호!"를 표시했습니다.
- 수신 후, CASE-1042는 4개 대신 5개의 항목을 보유했습니다.
- CASE-1042 업데이트는 두 개의 사진을 추가하고, 증인 진술서를 교체하고, invoice-7781.pdf를 제거했습니다.
- CASE-1043는 1개의 항목에서 3개로 갔습니다.
- CASE-1044는 모든 바이트를 유지했습니다.
- 세 개의 아카이브의 모든 11개 항목은 AES-256을 적용받았습니다.
- 각 항목은 원본 파일의 SHA-256과 일치했습니다.
- 계획은 추출된 복사본에서 모든 준비된 아카이브를 구축했으며, 단일 항목인 CASE-1043도 포함했으며, 아카이브를 열어 편집하지 않았습니다.
- 암호화는 업데이트 프로그램의 유일한 저장 이전에 실행되었습니다.
- 디렉토리 파서는 각 항목의 이름과 AES 강도 바이트만 읽고 크기는 읽지 않았습니다.
- 세 번째 질문의 끝에서, 아카이브 감사 서브 에이전트가 한 번 실행되었고 기록되지 않은 IronZIP 멤버는 보고되지 않았습니다.
- 깨끗한 재구성은 2.1초 내에 들어오는 파일이 있는 케이스 모두를 통과했고 CASE-1044를 건너뛰었다고 보고했습니다.
- 재구성에서 생성된 항목은 실행에서 생성된 항목과 일치했습니다.
- 잘못된 비밀번호로, 세 가지 사례 모두 "잘못된 비밀번호!!"로 추출에 실패했습니다.
- 그 잘못된 비밀번호 실행에서, 아카이브 해시는 변경되지 않았고, 프로세스는 코드 1로 종료되었습니다.
- 네 번째 질문 전에, 잘못된 비밀번호는 처음 추출에서 처리되지 않은 예외와 보고 없이 프로그램을 중지시켰으며, 해시는 여전히 일치했습니다.
- 일부 단계는 페이지와 달리 작동했습니다. 모든 질문은 재개의 헤드리스 세션으로 무인 전송되었으므로 /model 선택은 커맨드 라인 옵션으로 전달되고 매 새 질문은 수동으로 재시작 없이 CLAUDE.md를 재로드했습니다. 그 모드에서는 계획 대화 상자가 제공되지 않아서, 계획은 입력된 응답으로 승인되었습니다. 네 번째 질문의 증거는 셸 명령으로 실행되어, 프로그램은 자식 프로세스 코드를 얻지 않았으며 자식 플래그를 읽지 않습니다. 네 번째 질문 동안, Claude Code는 올바른 비밀번호로 하나의 입력을 한 번 실행하여 동일한 항목으로 CASE-1042 및 CASE-1043을 다시 작성했습니다.
Cursor 안내서는 또한 모든 파일 변경 전에 계획하고, 실행 계획 모드에서 IronZIP 포트를 편집 가능한 Markdown 계획으로 저장했습니다. ChatGPT Codex 안내서에서는 입력 규칙이 AGENTS.md에 작성되며, Codex가 어떤 작업을 시작하기 전에 이 파일을 로드합니다. 이 안내서는 CLAUDE.md를 사용합니다. AI 코딩 도우미 안내서는 고정 패스 목록을 가진 하나의 IronZIP 작업을 설정하고, 공유된 실행 기록은 Claude Code 버전, 모델, 질문 타이밍 및 이러한 결과 뒤의 테스트 머신을 나열합니다.
문제 해결
- 첫 번째 아카이브 열기가 라이선스 예외를 던지는 경우 IronZIP 라이선스 키
- 보호된 아카이브가 비밀번호를 거부하면 보호된 ZIP 접근
- 사례 아카이브가 고전 ZIP 한계를 넘어 성장하면 IronZIP 파일 및 아카이브 크기 제한
질문?
질문이 있으시면 support@ironsoftware.com으로 문의하세요.
커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.