Wie verwendet man IronZIP mit Claude Code
Ein Fallarchiv, das aktualisiert wurde, kann mit dem richtigen Passwort geöffnet werden, alle Dateien auflisten und sauber extrahieren und dennoch seine Beweise unter dem alten ZIP-Chiffre statt AES-256 halten. Nichts in der Dateiliste zeigt die Änderung. Claude Code ist Anthropics Codierungsagent, verfügbar über die Befehlszeile, innerhalb von VS Code und JetBrains IDEs, als Desktop-App und im Browser. Wo immer es läuft, liest es das Repository, bearbeitet Dateien und führt Shell-Befehle aus, was ihm ermöglicht, ein aktualisiertes Archiv zu erstellen, es zu extrahieren, sein Rohverzeichnis zu lesen und jede Datei zu vergleichen, bevor das Original ersetzt wird.
IronZIP öffnet, bearbeitet und speichert .NET-Passwort-geschützte ZIP-Dateien mit AES-128, AES-256 oder dem älteren Traditional-Chiffre, auch als ZipCrypto bekannt. Jede Bearbeitung ist ein Aufruf. Welcher Aufruf das Archiv öffnet, wie eine korrigierte Datei ihren alten Eintrag ersetzt und ob die Verschlüsselung vor dem Speichern erneut gesetzt wird, bestimmen das Ergebnis, und eine falsche Wahl bei einem von ihnen löst keine Ausnahme aus. Der Rest dieser Seite bereitet Claude Code auf eine monatliche Beweiserfassung vor, mit vier getesteten Eingabeaufforderungen und dem IronZIP-Verhalten hinter jeder.
Zwei Modelleinstellungen decken die Sitzung ab. Sonnet behandelt die Auflistung und die Projektregeln, und das Opusplan-Alias plant den Updater mit Opus und schreibt ihn mit Sonnet.
SchnellstartStarten Sie claude aus dem Repository-Ordner und führen Sie /model sonnet vor dieser Anforderung aus.
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.
Erwarten Sie, dass CASE-1043 selbst mit dem richtigen Passwort fehlschlägt. Der Abschnitt über das Öffnen eines existierenden ZIP erklärt warum.
Minimaler Arbeitsablauf (5 Schritte)
- Laden Sie die C# ZIP-Bibliothek von NuGet herunter
- Starten Sie Claude Code im Repository und wählen Sie ein Modell mit /model
- Legen Sie die Aktualisierungsregeln von IronZIP in CLAUDE.md fest und erstellen Sie einen Unteragenten zur Überprüfung, der nicht bearbeiten kann.
- Planen Sie den Updater im Planmodus und legen Sie jedes neue Archiv außerhalb des Archive-Ordners ab.
- Extrahieren Sie jedes abgelegte Archiv, vergleichen Sie dessen Dateien und lesen Sie dessen Verzeichnis, bevor es das Original ersetzt.
Was macht Claude Code in einem .NET-Archivprojekt?
Claude Code schreibt den Updater, erstellt jedes abgelegte Archiv, entpackt es, liest dessen Verzeichnis und listet die Prüfungen auf, die nicht bestanden wurden. Nach einem fehlgeschlagenen Test bearbeitet es den Code und führt die gesamte Erfassung erneut durch. Ihr Teil ist es, festzulegen, was jedes Fallarchiv enthalten muss, und am Ende den Bericht zu lesen.
Nennen Sie IronZIP als die einzige Archiv-Bibliothek im ersten Eingabeaufforderung. Angreifer veröffentlichen schädliche Pakete unter Namen, die KI-Codierungswerkzeuge halluzinieren, und ein Agent, der sein eigenes Paket auswählt, kann eines installieren. Der Angriff wird slopsquatting genannt.
Wie richten Sie Claude Code ein?
Anthropics Schnellstart behandelt die Installation von Claude Code und die Anmeldung. Eine funktionierende Installation druckt eine Versionsnummer für claude --version.
Wie richten Sie ein Projekt ein, in dem Claude Code arbeiten kann?
Das Test-Repository, CaseArchive, ist ein .NET 9-Konsolenprojekt, das drei AES-256-Fallarchive in einem Archivordner, neue Dateien für zwei davon in einem Eingangsordner und eine Markdown-Seite in einem Dokumentationsordner enthält, der die Aufnahmeregeln festlegt. Ein neuer Dateiname wird hinzugefügt, ein passender Name ersetzt seinen Eintrag, Namen in remove.txt kommen heraus und ein Fall ohne Eingangsordner bleibt, wie er ist. Das Archivpasswort stammt von CASE_ARCHIVE_PASSWORD.
Regeln, die in CLAUDE.md geschrieben sind, werden zu Beginn jeder Sitzung geladen. Mit dem Paket nach dem Schnellstart schreibt die nächste Anfrage diese Datei und einen Prüfer.
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
Eine laufende Claude Code-Sitzung erkennt keinen neu erstellten .claude/agents-Ordner, also übernehmen Sie diesen Ordner mit einer Platzhalterdatei darin, bevor Sie beginnen.
Richten Sie die Lizenz vor dem ersten Öffnen ein. Ohne Schlüssel werfen sowohl das Öffnen als auch das Extrahieren LicensingException, und die Nachricht sagt "Production License Required". Die Variable IRONZIP_LICENSE_KEY allein lizenziert IronZIP nicht. Im Kalibrierungstest war die Variable gesetzt und License.IsLicensed blieb falsch, daher ordnet das Programm IronZip.License.LicenseKey davon zu. Die Seite IronZIP-Lizenzschlüssel erklärt, wie man einen Schlüssel erhält und wo er festgelegt werden kann.
Welche IronZIP-Aktualisierungsregeln gehören in CLAUDE.md?
Die Kalibrierungstestsonderung maß jede Zeile auf IronZIP 2026.10.2 gegen die Fixture-Archive und ein passendes Testarchiv. Fügen Sie den Block unter der Überschrift Case archives ein und starten Sie dann mit claude --continue neu, damit die Sitzung ihn liest.
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.
Warum verliert ein aktualisiertes Archiv seine AES-256-Verschlüsselung?
Beim Speichern wird auf das Traditional-Chiffre zurückgegriffen, wenn nichts die Methode erneut setzt. In unserem Kalibrierungstest wurde CASE-1044 mit seinem Passwort geöffnet und ohne Änderung gespeichert, alle drei Einträge wurden mit dem Traditional-Chiffre geschrieben. Pythons standard zipfile Modul, das AES-Einträge nicht lesen kann, entschlüsselte dann alle mit dem Passwort. Der Aufruf von Encrypt mit EncryptionMethods.AES256 vor dem Speichern behielt alle fünf Einträge eines aktualisierten CASE-1042 bei AES-256, einschließlich der drei neuen Einträge. Ein ZipSaveOptions, das AES-256 nennt, an den Speicheraufruf übergeben, tat das Gleiche für ein Archiv mit einem gelöschten Eintrag.
Die Extraktion mit dem Passwort gelingt so oder so, also zeigt nur das Rohverzeichnis das Downgrade. Jeder AES-Eintrag trägt das zusätzliche Feld 0x9901, dessen Stärkebyte bei einem 256-Bit-Schlüssel 3 ist, und die tradionellen Einträge im Test hatten kein solches Feld.
Wie öffnet man ein bestehendes ZIP mit IronZIP?
Übergeben Sie den Pfad und das Passwort an den Konstruktor. Das Beispiel zum Hinzufügen von Dateien zu ZIP öffnet sein Archiv stattdessen mit FromFile, und im Test wurde ein Archiv erstellt, das CASE-1042.zip als ein unverschlüsselter Eintrag neben dem hinzugefügten Foto enthielt. IronZIPs skill.md warnt davor, dass FromFile immer ein neues Archiv erstellt und den Konstruktor und FromArchive als die Aufrufe nennt, die eines öffnen.
Ein Archiv mit einem einzigen geschützten Eintrag benötigt eine andere Methode. In den Tests warf ein AES-256-Archiv dieser Art "Invalid Password!" vom Konstruktor, FromArchive und dem Byte-Array-Konstruktor, während die Extraktion mit dem gleichen Passwort funktionierte. Der Konstruktor warf denselben Fehler bei einem traditionellen Archiv mit einem Eintrag. Der Neubau extrahiert das Archiv in einen temporären Ordner, kopiert die eingehenden Dateien hinein und speichert ein neues Archiv mit Encrypt zuerst aufgerufen. Das erneuerte CASE-1043 enthielt drei AES-256-Einträge und wurde anschließend normal geöffnet.
Wie fordert man funktionierenden IronZIP-Code an?
Führen Sie /model opusplan aus, dann wechseln Sie Shift+Tab bis der Planmodus in der Statusleiste erscheint, und senden Sie die Anfrage.
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/.
Jede Überprüfung in der Eingabeaufforderung blockiert einen anderen falschen Durchgang.
- Hashes gegen die Quellen: ein ersetzter Eintrag wird mit seiner eingehenden Datei verglichen, so dass eine Aussage, die ihren alten Text behielt, fehlschlägt.
- Das Verzeichnis analysieren: ein doppelter Name und ein fehlender Eintrag passieren die Extraktion ebenfalls unbemerkt.
- Erststaging: eine Aktualisierung, die einen Test nicht besteht, lässt das Originalarchiv, wie es war.
Encrypt vor jedem Speichern aufruft, CASE-1043 aus einer extrahierten Kopie wieder aufbaut und keinen ersetzten Namen zweimal speichern kann, entweder weil er den alten Eintrag zuerst löscht oder weil er jedes abgestufte Archiv von Grund auf neu erstellt. Ein Plan, der einen dieser Punkte verpasst, schreibt Archive, die noch korrekt aufgelistet sind.Kann ein falsches Passwort ein Fallarchiv beschädigen?
IronZIP listet ein AES-geschütztes Archiv auf, das mit einem beliebigen Passwort geöffnet wurde, so dass der erste Fehler spät kommt. Im Kalibrierungstest warf das Speichern eine ZipException ("Invalid password for AES") und schrieb keine Datei, und das Extrahieren warf eine ArgumentException ("Invalid password!!"). Die letzte Eingabeaufforderung bringt den Agenten dazu zu beweisen, dass dieser Weg die Originale unverändert lässt.
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.
Was haben die Aufforderungen in einem realen Lauf erzeugt?
Claude Code erhielt die vier Eingabeaufforderungen in der Reihenfolge innerhalb einer einzigen Sitzung, und der Regelblock wurde vor der dritten zu CLAUDE.md hinzugefügt. Nach dem Durchlauf wurde der übergebene Code aus einem sauberen Klon wieder aufgebaut und gegen die ursprünglichen Archive ausgeführt. Die Python-Bibliothek pyzipper, die keinen Code mit IronZIP teilt, las jedes Ergebnis.
- Die Schnellstartliste, die Claude Code selbst ausführte, zeigte 4 verschlüsselte Einträge für CASE-1042, 3 für CASE-1044 und "Invalid Password!" für CASE-1043.
- Nach der Aufnahme hielt CASE-1042 5 Einträge anstelle von 4.
- Das CASE-1042-Update fügte zwei Fotos hinzu, ersetzte die Zeugenaussage und entfernte invoice-7781.pdf.
- CASE-1043 ging von 1 Eintrag auf 3.
- CASE-1044 behielt jedes Byte.
- Alle 11 Einträge in den drei Archiven trugen AES-256.
- Jeder Eintrag stimmte mit dem SHA-256 seiner Quelldatei überein.
- Der Plan baute jedes abgestufte Archiv aus einer extrahierten Kopie, einschließlich des Einzel-Eintrags CASE-1043, und öffnete niemals ein Archiv, um es zu bearbeiten.
- Encrypt lief vor dem einzigen Speicher des Updaters.
- Der Verzeichnisparser las den Namen jedes Eintrags und das AES-Stärkebyte und keine Größen.
- Am Ende der dritten Eingabeaufforderung lief der Archive-Auditor-Unteragent einmal und meldete kein nicht dokumentiertes IronZIP-Mitglied.
- Der saubere Neubau bestand beide Fälle, die eingehende Dateien hatten, in 2,1 Sekunden und meldete CASE-1044 als übersprungen.
- Einträge aus dem Neubau stimmten mit denen aus dem Durchlauf überein.
- Mit einem falschen Passwort scheiterten alle drei Fälle bei der Extraktion mit "Invalid password!!".
- In diesem falsch-Passwort-Durchlauf änderten sich die Archiv-Hashes nicht und der Prozess wurde mit Code 1 beendet.
- Vor der vierten Eingabeaufforderung stoppte ein falsches Passwort das Programm bei der ersten Extraktion mit einer unbehandelten Ausnahme und keinem Bericht, und die Hashes stimmten noch überein.
- Einige Schritte liefen anders als die Seite. Jede Eingabeaufforderung wurde unbeaufsichtigt gesendet, als eine fortgesetzte kopflose Sitzung, so dass die /model-Auswahlen als Befehlszeilenoptionen übergeben wurden und jede neue Eingabeaufforderung CLAUDE.md ohne manuellen Neustart neu lud. Der Plan-Dialog war in diesem Modus nicht verfügbar, so dass der Plan durch eine getippte Antwort genehmigt wurde. Der Beweis der vierten Eingabeaufforderung lief als Shell-Befehle ab, so dass das Programm keinen Kindprozess-Code erhielt und niemals das Kind-Flag liest. Während der vierten Eingabeaufforderung führte Claude Code die Aufnahme auch einmal mit dem richtigen Passwort aus, was CASE-1042 und CASE-1043 mit denselben Einträgen umschrieb.
Der Cursor-Leitfaden plant auch vor jeder Dateiänderung, und in seinem Lauf speicherte der Planmodus den IronZIP-Port als bearbeitbaren Markdown-Plan. Im ChatGPT-Codex-Leitfaden werden die Aufnahmeregeln in AGENTS.md geschrieben, eine Datei, die Codex lädt, bevor irgendeine Arbeit beginnt, wo dieser Leitfaden CLAUDE.md verwendet. Der Leitfaden für KI-Codierungsassistenten setzt eine komplette IronZIP-Aufgabe mit einer festen Passliste, und das gemeinsame Laufprotokoll nennt die Claude Code-Version, die Modelle, die Eingabeaufforderungszeiten und die Testmaschine hinter diesen Ergebnissen.
Fehlerbehebung
- IronZIP-Lizenzschlüssel, wenn das Öffnen des ersten Archivs eine Lizenzierungs-Exception auswirft
- Zugriff auf geschütztes ZIP, wenn ein geschütztes Archiv sein Passwort ablehnt
- IronZIP-Datei- und Archivgrößenbeschränkungen, wenn ein Fallarchiv über die klassischen ZIP-Grenzen hinaus wächst
Fragen?
Wenn Sie Fragen haben, wenden Sie sich an support@ironsoftware.com.
Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.