Comment utiliser IronZIP avec Claude Code
Une archive de cas qui a été mise à jour peut s'ouvrir avec le bon mot de passe, lister chaque fichier et être extraite proprement, tout en conservant ses preuves sous l'ancien chiffrement ZIP plutôt que sous AES-256. Rien dans la liste des fichiers ne montre le changement. Claude Code est l'agent de codage d'Anthropic, disponible en ligne de commande, à l'intérieur de VS Code et des IDE JetBrains, en tant qu'application de bureau et dans un navigateur. Où qu'il fonctionne, il lit le dépôt, édite les fichiers et exécute des commandes shell, ce qui lui permet de préparer une archive mise à jour, de l'extraire, de lire son répertoire brut et de comparer chaque fichier avant que l'original ne soit remplacé.
IronZIP ouvre, édite et enregistre des fichiers ZIP protégés par mot de passe depuis .NET, avec AES-128, AES-256 ou le chiffrement traditionnel plus ancien, également connu sous le nom de ZipCrypto. Chaque édition est un seul appel. Quel appel ouvre l'archive, comment un fichier corrigé remplace son ancienne entrée, et si le chiffrement est à nouveau défini avant l'enregistrement déterminent le résultat, et un mauvais choix dans l'un d'eux ne soulève aucune exception. Le reste de cette page prépare Claude Code pour une prise de preuves mensuelle, avec quatre invites testées et le comportement d'IronZIP derrière chacune.
Deux configurations de modèle couvrent la session. Sonnet gère la liste et les règles du projet, et l'alias opusplan planifie le module de mise à jour avec Opus et l'écrit avec Sonnet.
Démarrage rapideLancez claude depuis le dossier du dépôt et exécutez /model sonnet avant cette requête.
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.
Attendez-vous à ce que CASE-1043 échoue même avec le mot de passe correct. La section sur l'ouverture d'un ZIP existant en explique la raison.
Flux de travail minimal (5 étapes)
- Téléchargez la bibliothèque ZIP C# depuis NuGet
- Lancez Claude Code dans le dépôt et choisissez un modèle avec /model
- Mettez les règles de mise à jour d'IronZIP dans CLAUDE.md et créez un sous-agent de révision qui ne peut pas éditer
- Planifiez le module de mise à jour en mode planification, préparant chaque nouvelle archive en dehors du dossier des archives
- Extrayez chaque archive préparée, comparez ses fichiers et lisez son répertoire avant qu'elle ne remplace l'original
Que fait Claude Code dans un projet d'archive .NET ?
Claude Code écrit le module de mise à jour, construit chaque archive préparée, la décompresse, lit son répertoire et liste les vérifications qui n'ont pas été passées. Après un échec de vérification, il modifie le code et relance toute la prise. Votre rôle consiste à définir ce que doit contenir chaque archive de cas et à lire le rapport à la fin.
Nommez IronZIP comme seule bibliothèque d'archives dans la première invite. Les attaquants publient des packages malveillants sous des noms que les outils de codage IA hallucinent, et un agent qui choisit son propre package peut en installer un. L'attaque est appelée slopsquatting.
Comment configurer Claude Code ?
Le démarrage rapide d'Anthropic couvre l'installation de Claude Code et la connexion. Une installation fonctionnelle imprime un numéro de version pour claude --version.
Comment configurer un projet dans lequel Claude Code peut travailler ?
Le dépôt de test, CaseArchive, est un projet console .NET 9 contenant trois archives de cas AES-256 dans un dossier d'archives, de nouveaux fichiers pour deux d'entre elles dans un dossier entrant, et une page Markdown dans un dossier docs qui définit les règles de prise. Un nouveau nom de fichier est ajouté, un nom correspondant remplace son entrée, les noms listés dans remove.txt sortent, et un cas sans dossier entrant reste tel quel. Le mot de passe de l'archive provient de CASE_ARCHIVE_PASSWORD.
Les règles écrites dans CLAUDE.md chargent au début de chaque session. Avec le package en place après le démarrage rapide, la prochaine demande écrit ce fichier et un réviseur.
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
Une session Claude Code en cours ne détecte pas un dossier .claude/agents nouvellement créé, donc engagez ce dossier, avec un fichier de remplacement dedans, avant de commencer.
Configurez la licence avant la première ouverture. Sans clé, l'ouverture et l'extraction renvoient toutes deux LicensingException, et le message indique "Licence de production requise". La variable IRONZIP_LICENSE_KEY seule ne licence pas IronZIP. Dans la sonde de calibration, la variable était définie et License.IsLicensed restait faux, donc le programme attribue IronZip.License.LicenseKey à partir de celle-ci. La page Clés de licence IronZIP explique comment obtenir une clé et où elle peut être définie.
Quelles règles de mise à jour d'IronZIP appartiennent à CLAUDE.md ?
La sonde de calibration a mesuré chaque ligne d'IronZIP 2026.10.2 par rapport aux archives de référence et une archive de sonde correspondante. Collez le bloc sous le titre des archives de cas, puis redémarrez avec claude --continue afin que la session le lise.
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.
Pourquoi une archive mise à jour perd-elle son chiffrement AES-256 ?
L'enregistrement revient au chiffrement traditionnel lorsque rien ne redéfinit la méthode. Dans notre sonde de calibration, l'ouverture de CASE-1044 avec son mot de passe et son enregistrement sans aucun changement du tout a écrit les trois entrées avec le chiffrement traditionnel. Le module standard de Python zipfile, qui ne peut pas lire les entrées AES, a ensuite déchiffré chacune d'elles avec le mot de passe. Appeler Encrypt avec EncryptionMethods.AES256 avant l'enregistrement a conservé toutes les cinq entrées d'un CASE-1042 mis à jour en AES-256, y compris les trois nouvelles entrées. Une ZipSaveOptions qui nomme AES-256, passée à l'appel d'enregistrement, a fait de même pour une archive avec une entrée supprimée.
L'extraction avec le mot de passe réussit de toute façon, donc seul le répertoire brut montre la rétrogradation. Chaque entrée AES porte le champ supplémentaire 0x9901, dont l'octet de force est 3 pour une clé de 256 bits, et les entrées traditionnelles dans la sonde n'avaient pas un tel champ.
Comment ouvrir un ZIP existant avec IronZIP ?
Passez le chemin et le mot de passe au constructeur. L'exemple d'ajout de fichiers à ZIP ouvre son archive avec FromFile à la place, et dans la sonde cela a produit une archive contenant CASE-1042.zip comme une entrée non chiffrée à côté de la photo ajoutée. Le skill.md d'IronZIP avertit que FromFile construit toujours une nouvelle archive et nomme le constructeur et FromArchive comme les appels qui en ouvrent une.
Une archive avec une seule entrée protégée nécessite une méthode différente. Dans les sondes, une archive AES-256 de ce type a lancé "Mot de passe invalide !" depuis le constructeur, FromArchive et le constructeur de tableau d'octets, tandis que l'extraction avec le même mot de passe fonctionnait. Le constructeur a lancé la même erreur pour une archive traditionnelle avec une entrée. La reconstruction extrait l'archive dans un dossier temporaire, y copie les fichiers entrants, et enregistre une nouvelle archive avec Encrypt appelé en premier. Le CASE-1043 reconstruit contenait trois entrées AES-256 et s'ouvrait normalement par la suite.
Comment demander un code IronZIP qui compile ?
Exécutez /model opusplan, puis faites défiler Shift+Tab jusqu'à ce que le mode planification apparaisse dans la barre d'état, et envoyez la requête.
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/.
Chaque vérification dans l'invite bloque un passage incorrect différent.
- Hachages contre les sources : une entrée remplacée est comparée avec son fichier entrant, donc une déclaration qui a conservé son ancien texte échoue.
- L'analyse du répertoire : un nom en double et une entrée manquante passent également l'extraction sans être remarqués.
- Préparation d'abord : une mise à jour qui échoue à une vérification laisse l'archive d'origine telle qu'elle était.
Encrypt avant chaque sauvegarde, reconstruit CASE-1043 à partir d'une copie extraite, et ne peut pas stocker un nom remplacé deux fois, soit parce qu'il supprime d'abord l'ancienne entrée, soit parce qu'il construit chaque archive mise en scène à partir de zéro. Un plan qui manque l'une de ces écritures archive toujours les listes correctement.Un mauvais mot de passe peut-il endommager une archive de cas ?
IronZIP liste une archive protégée par AES ouverte avec n'importe quel mot de passe, donc la première erreur survient tardivement. Dans la sonde de calibration, l'enregistrement a lancé ZipException ("Mot de passe invalide pour AES") et n'a écrit aucun fichier, et l'extraction a lancé ArgumentException ("Mot de passe invalide !"). La dernière invite fait prouver à l'agent que ce chemin laisse les originaux inchangés.
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.
Qu'est-ce que les messages ont produit lors d'une réelle exécution ?
Claude Code a reçu les quatre invites dans l'ordre au sein d'une seule session, et le bloc de règles a été ajouté à CLAUDE.md avant la troisième. Après l'exécution, le code engagé a été reconstruit à partir d'un clone propre et exécuté par rapport aux archives originales. La bibliothèque Python pyzipper, qui ne partage aucun code avec IronZIP, a lu chaque résultat.
- La liste de démarrage rapide, que Claude Code a exécutée elle-même, a montré 4 entrées chiffrées pour CASE-1042, 3 pour CASE-1044 et "Mot de passe invalide !" pour CASE-1043.
- Après la prise, CASE-1042 contenait 5 entrées au lieu de 4.
- La mise à jour de CASE-1042 a ajouté deux photos, remplacé la déclaration du témoin et supprimé invoice-7781.pdf.
- CASE-1043 est passé de 1 entrée à 3.
- CASE-1044 a conservé chaque octet.
- Toutes les 11 entrées des trois archives ont été chiffrées en AES-256.
- Chaque entrée correspondait au SHA-256 de son fichier source.
- Le plan a construit chaque archive préparée à partir d'une copie extraite, y compris le CASE-1043 à une seule entrée, et n'a jamais ouvert une archive pour l'éditer.
- Encrypt a été exécuté avant le seul enregistrement du module de mise à jour.
- L'analyseur du répertoire a lu le nom de chaque entrée et l'octet de force AES et aucune taille.
- À la fin de la troisième invite, le sous-agent d'audit d'archive a été exécuté une fois et a signalé aucun membre IronZIP non documenté.
- La reconstruction propre a passé les deux cas qui avaient des fichiers entrants en 2,1 secondes et a signalé que CASE-1044 était ignoré.
- Les entrées de la reconstruction correspondaient à celles de l'exécution.
- Avec un mauvais mot de passe, les trois cas ont échoué à l'extraction avec "Mot de passe invalide !".
- Lors de cette exécution avec mot de passe incorrect, les hachages de l'archive n'ont pas changé et le processus s'est terminé avec le code 1.
- Avant la quatrième invite, un mot de passe incorrect a arrêté le programme à la première extraction avec une exception non gérée et aucun rapport, et les hachages correspondaient toujours.
- Certaines étapes ont été exécutées différemment de la page. Chaque invite a été envoyée sans surveillance, en tant que session sans tête reprenant, donc les choix /model ont été passés comme options de ligne de commande et chaque nouvelle invite a rechargé CLAUDE.md sans redémarrage manuel. La boîte de dialogue plan n'était pas disponible dans ce mode, donc le plan a été approuvé par une réponse tapée. La preuve de la quatrième invite a été exécutée sous forme de commandes shell, de sorte que le programme n'a pas gagné de code de processus enfant et ne lit jamais le drapeau enfant. Lors de la quatrième invite, Claude Code a également exécuté la prise une fois avec le bon mot de passe, ce qui a réécrit CASE-1042 et CASE-1043 avec les mêmes entrées.
Le guide de Cursor planifie également avant tout changement de fichier, et lors de son exécution, le mode plan a enregistré le port IronZIP sous forme de plan Markdown modifiable. Dans le guide Codex de ChatGPT, les règles de prise sont écrites dans AGENTS.md, un fichier que Codex charge avant le début de tout travail, où ce guide utilise CLAUDE.md. Le guide des assistants de codage IA définit une tâche complète IronZIP avec une liste de passage fixe, et l'enregistrement d'exécution partagé nomme la version Claude Code, les modèles, les temps d'invite et la machine de test derrière ces résultats.
Dépannage
- Clé de licence IronZIP si l'ouverture de la première archive lance une exception de licence
- Accéder à un ZIP protégé si une archive protégée rejette son mot de passe
- Limites de taille de fichier et d'archive IronZIP si une archive de cas dépasse les limites classiques du ZIP
Des questions ?
Si vous avez des questions, contactez support@ironsoftware.com
Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.