Jak używać IronZIP z Claude Code

Curtis Chau
Curtis Chau
Zaktualizowano: 26 października 2026

Archiwum, które zostało zaktualizowane, może się otworzyć przy użyciu prawidłowego hasła, wylistować każdy plik i wyodrębnić się poprawnie, a nadal pozostaje chronione starym szyfrem ZIP zamiast AES-256. Nic na liście plików nie pokazuje zmiany. Claude Code to agent kodujący firmy Anthropic, dostępny z poziomu wiersza poleceń, w VS Code i IDE JetBrains, jako aplikacja desktopowa oraz w przeglądarce. Niezależnie od miejsca działania, czyta repozytorium, edytuje pliki i wykonuje polecenia powłoki, co pozwala mu na etapowanie zaktualizowanego archiwum, jego wyodrębnianie, odczyt surowego katalogu i porównanie każdego pliku przed zastąpieniem oryginału.

IronZIP otwiera, edytuje i zapisuje pliki ZIP chronione hasłem z .NET, używając AES-128, AES-256 lub starszego szyfru Traditional, znanego również jako ZipCrypto. Każda edycja to jedno wywołanie. To, które wywołanie otwiera archiwum, jak skorygowany plik zastępuje stare wejście oraz czy szyfrowanie jest ponownie ustawiane przed zapisem, decyduje o wyniku, a błędny wybór w którymkolwiek z nich nie zgłasza wyjątku. Reszta tej strony przygotowuje Claude Code do miesięcznego przyjmowania dowodów, z czterema przetestowanymi zapytaniami i zachowaniem IronZIP za każdym z nich.

Dwa ustawienia modelu obejmują sesję. Sonnet obsługuje listowanie i zasady projektu, a alias opusplan planuje aktualizator z Opus i pisze go z Sonnet.

Szybki start
NuGetInstalacja z NuGet

PM > Install-Package IronZip

Zainstaluj IronZIP, wykonując powyższe polecenie w konsoli Menedżera Pakietów NuGet lub wyszukaj pakiet w Menedżerze Pakietów NuGet.

Uruchomić claude z folderu repozytorium i wykonać /model sonnet przed tym żądaniem.

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.
Text

Oczekuj, że CASE-1043 nie powiedzie się nawet z prawidłowym hasłem. Sekcja dotycząca otwierania istniejącego ZIP wyjaśnia dlaczego.



Co robi Claude Code w projekcie archiwum .NET?

Claude Code pisze aktualizator, buduje każde zarchiwizowane archiwum, rozpakowuje je, czyta jego katalog i wymienia kontrole, które nie przeszły. Po nieudanej kontroli edytuje kod i uruchamia cały proces ponownie. Należy zdefiniować, co każde archiwum sprawy musi zawierać i przeczytać raport na końcu.

Nazwij IronZIP jako jedyną bibliotekę archiwum w pierwszym żądaniu. Atakujący publikują złośliwe pakiety pod nazwami, które narzędzia do kodowania AI halucynują, a agent, który wybiera własny pakiet, może go zainstalować. Atak nazywa się slopsquatting.

Jak skonfigurować Claude Code?

Szybki start Anthropic pokrywa instalację Claude Code i logowanie. Działająca instalacja wyświetla numer wersji dla claude --version.

Jak skonfigurować projekt, w którym Claude Code może pracować?

Repozytorium testowe, CaseArchive, to projekt konsoli .NET 9 zawierający trzy archiwa spraw AES-256 w folderze archiwów, nowe pliki do dwóch z nich w folderze przychodzących oraz stronę Markdown w folderze dokumentacji, która ustawia zasady przyjmowania. Nowa nazwa pliku jest dodawana, odpowiadająca nazwa zastępuje jej wcześniejsze wejście, nazwy wymienione w remove.txt wychodzą, a sprawa bez folderu przychodzących pozostaje bez zmian. Hasło do archiwum pochodzi z CASE_ARCHIVE_PASSWORD.

Zasady zapisane w CLAUDE.md ładują się na początku każdej sesji. Z pakietem na miejscu po Szybkim Starcie, kolejne żądanie zapisuje ten plik i recenzenta.

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
Text

Bieżąca sesja Claude Code nie wykrywa nowo utworzonego folderu .claude/agents, więc zatwierdź ten folder z plikiem zastępczym w nim przed rozpoczęciem.

Skonfigurować licencję przed pierwszym otwarciem. Bez klucza, otwieranie i wyodrębnianie oba wyrzucają LicensingException, a wiadomość mówi "Wymagana licencja produkcyjna". Zmienna IRONZIP_LICENSE_KEY sama w sobie nie licencjuje IronZIP. W sondzie kalibracyjnej zmienna była ustawiona i License.IsLicensed pozostawała false, więc program przypisuje IronZip.License.LicenseKey z niej. Strona kluczy licencyjnych IronZIP wyjaśnia, jak uzyskać klucz i gdzie można go ustawić.

Które zasady aktualizacji IronZIP należą do CLAUDE.md?

Sonda kalibracyjna zmierzyła każdą linię w IronZIP 2026.10.2 na tle archiwów testowych i odpowiadającego archiwum sondy. Wkleić blok pod nagłówkiem Archiwa spraw, a następnie uruchomić ponownie z claude --continue, aby sesja go przeczytała.

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.
Markdown

Dlaczego zaktualizowane archiwum traci szyfrowanie AES-256?

Zapis wraca do szyfru Traditional, gdy nic nie ustawia ponownie metody. W naszej sondzie kalibracyjnej, otwarcie CASE-1044 z jego hasłem i zapisanie go bez zmian zapisało wszystkie trzy wpisy z szyfrem Traditional. Standardowy moduł zipfile Pythona, który nie może czytać wpisów AES, następnie odszyfrował każdy z nich hasłem. Wywołanie Encrypt z EncryptionMethods.AES256 przed zapisem utrzymało wszystkie pięć wpisów zaktualizowanego CASE-1042 jako AES-256, w tym trzy nowe wpisy. Jeden ZipSaveOptions, który nazywa AES-256, przekazany do wywołania zapisu, zrobił to samo dla archiwum z jednym usuniętym wpisem.

Wyodrębnianie przy użyciu hasła udaje się w każdym przypadku, więc tylko surowy katalog pokazuje degradację. Każdy wpis AES niesie ze sobą dodatkowe pole 0x9901, którego bajt siły wynosi 3 dla klucza 256-bitowego, a wpisy Traditional w sondzie nie miały takiego pola.

Jak otworzyć istniejący ZIP za pomocą IronZIP?

Przekazać ścieżkę i hasło do konstruktora. Przykład dodawania plików do ZIP otwiera swoje archiwum z FromFile zamiast tego, a w sondzie to wygenerowało archiwum zawierające CASE-1042.zip jako jeden niezaszyfrowany wpis obok dodanego zdjęcia. skill.md IronZIP ostrzega, że FromFile zawsze buduje nowe archiwum i nazywa konstruktor i FromArchive jako wywołania, które otwierają jedno.

Archiwum z jednym chronionym wpisem wymaga innej metody. W sondach, archiwum AES-256 tego rodzaju wyrzuciło "Nieprawidłowe hasło!" od konstruktora, FromArchive i konstruktora tablicy bajtów, podczas gdy wyodrębnianie z tym samym hasłem działało. Konstruktor wyrzucił ten sam błąd dla archiwum Traditional z jednym wpisem. Odświeżenie wyodrębnia archiwum do tymczasowego folderu, kopiuje pliki przychodzące i zapisuje nowe archiwum, wywołując najpierw Encrypt. Odbudowane CASE-1043 zawierało trzy wpisy AES-256 i otwierało się normalnie potem.

Jak generować kod IronZIP, który się kompiluje?

Uruchomić /model opusplan, następnie cyklicznie Shift+Tab aż tryb planowania pojawi się w pasku stanu i wysłać żądanie.

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/.
Text

Każda kontrola w zapytaniu blokuje inną fałszywą zgodność.

  1. Hashowanie względem źródeł: zastępowany wpis jest porównywany z plikiem przychodzącym, więc oświadczenie, które zachowuje swój stary tekst, nie przechodzi.
  2. Parsowanie katalogu: duplikat nazwy i brakujący wpis również przechodzą niezauważone podczas wyodrębniania.
  3. Najpierw etapowanie: aktualizacja, która nie przechodzi kontroli, pozostawia oryginalne archiwum bez zmian.
Porady: Zaakceptuj plan, jeśli wzywa Encrypt przed każdym zapisaniem, odbudowuje CASE-1043 z wyodrębnionej kopii i nie może przechowywać zamienionej nazwy dwa razy, albo dlatego, że najpierw usuwa stary wpis, albo dlatego, że buduje każdy zarchiwizowany etap od podstaw. Plan, który pomija którykolwiek z tych zapisów, archiwizuje te, które wciąż są poprawnie wymienione.

Czy błędne hasło może uszkodzić archiwum sprawy?

IronZIP wylistowuje archiwum chronione AES otwarte za pomocą dowolnego hasła, więc pierwszy błąd pojawia się późno. W sondzie kalibracyjnej zapis wyrzucił ZipException ("Nieprawidłowe hasło dla AES") i nie zapisał pliku, a wyodrębnianie wyrzuciło ArgumentException ("Nieprawidłowe hasło!!"). Ostatnie zapytanie sprawia, że agent musi udowodnić, że ta ścieżka nie zmienia oryginałów.

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.
Text

Co wyprodukowały zapytania w rzeczywistym uruchomieniu?

Claude Code otrzymał cztery zapytania w kolejności w ramach jednej sesji, a blok zasad został dodany do CLAUDE.md przed trzecim. Po zakończeniu działania, zatwierdzony kod został odbudowany z czystej kopii i uruchomiony na oryginalnych archiwach. Biblioteka Pythona pyzipper, która nie dzieli się kodem z IronZIP, odczytała każdy wynik.

  • Lista szybkiego startu, którą uruchomił Claude Code, pokazała 4 zaszyfrowane wpisy dla CASE-1042, 3 dla CASE-1044 i "Nieprawidłowe hasło!" dla CASE-1043.
  • Po przyjęciu, CASE-1042 zawierało 5 wpisów zamiast 4.
  • Aktualizacja CASE-1042 dodała dwa zdjęcia, zastąpiła zeznanie i usunęła invoice-7781.pdf.
  • CASE-1043 wzrosło z 1 do 3 wpisów.
  • CASE-1044 utrzymało każdy bajt.
  • Wszystkie 11 wpisów w trzech archiwach miało AES-256.
  • Każdy wpis pasował do SHA-256 pliku źródłowego.
  • Plan zbudował każde zarchiwizowane archiwum z wyodrębnionej kopii, w tym jedno-wpisowe CASE-1043, i nigdy nie otworzył archiwum, aby je edytować.
  • Szyfrowanie uruchomiło się przed jedynym zapisem przez aktualizator.
  • Parser katalogu odczytał nazwę każdego wpisu i bajt siły AES, ale nie rozmiary.
  • Na koniec trzeciego zapytania, podagent audytora archiwum uruchomił się raz i nie zgłosił żadnego nieudokumentowanego członka IronZIP.
  • Czysta odbudowa przeszła oba przypadki, które miały pliki przychodzące w 2,1 sekundzie i zgłosiła CASE-1044 jako pominięte.
  • Wpisy z odbudowy pasowały do tych z uruchomienia.
  • Przy błędnym haśle wszystkie trzy przypadki zawiodły przy wyodrębnianiu z "Nieprawidłowe hasło!!".
  • W tym błędnym uruchomieniu hasła, hashe archiwum nie zmieniły się i proces zakończył się z kodem 1.
  • Przed czwartym zapytaniem, błędne hasło zatrzymało program przy pierwszym wyodrębnianiu z nieobsługiwanym wyjątkiem i bez raportu, a hashe nadal się zgadzały.
  • Niektóre kroki uruchomiono inaczej niż na stronie. Każde zapytanie było wysyłane bez nadzoru, jako wznowiona sesja bezgłowa, więc wybory /model były przekazywane jako opcje w wierszu poleceń, a każde nowe zapytanie przeładowywało CLAUDE.md bez ręcznego restartu. W tym trybie dialog planu nie był dostępny, więc plan był zatwierdzany przez wpisaną odpowiedź. Czwarty dowód zapytania działał jako polecenia powłoki, więc program nie zyskał kodu procesu-child i nigdy nie odczytuje flagi child. Podczas czwartego zapytania, Claude Code także uruchomił przyjęcie raz z prawidłowym hasłem, co przepisało CASE-1042 i CASE-1043 z tymi samymi wpisami.

Przewodnik kursora również planuje przed jakimikolwiek zmianami plików, a w swoim uruchomieniu Tryb Planowania zapisał port IronZIP jako edytowalny plan Markdown. W przewodniku ChatGPT Codex, zasady przyjmowania są zapisane w AGENTS.md, plik, który Codex ładuje przed rozpoczęciem jakiejkolwiek pracy, gdzie ten przewodnik używa CLAUDE.md. Przewodnik po asystentach kodujących AI ustawia jedno pełne zadanie IronZIP z ustalonym wykazem przejść, a dzielony zapis uruchomienia nazywa wersję Claude Code, modele, czasy zapytań i maszynę testową stojącą za tymi wynikami.


Rozwiązywanie problemów


Pytania?

Jeśli są jakiekolwiek pytania, należy skontaktować się z support@ironsoftware.com

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

Czytaj więcej

Gotowy, aby rozpocząć?

Pobrania z NuGet 25,383Wersja:2026.11właśnie wydane