Cómo usar IronZIP con Claude Code

Curtis Chau
Curtis Chau
Actualizado: 26 de octubre de 2026

Un archivo de caso que ha pasado por una actualización puede abrirse con la contraseña correcta, listar cada archivo y extraerlo limpiamente, y aún mantener su evidencia bajo el antiguo cifrado ZIP en lugar del AES-256. Nada en la lista de archivos muestra el cambio. Claude Code es el agente de codificación de Anthropic, disponible desde la línea de comandos, dentro de VS Code y JetBrains IDEs, como una aplicación de escritorio y en un navegador. Dondequiera que se ejecute, lee el repositorio, edita archivos y ejecuta comandos de shell, lo que le permite preparar un archivo actualizado, extraerlo, leer su directorio bruto y comparar cada archivo antes de que se reemplace el original.

IronZIP abre, edita y guarda archivos ZIP protegidos por contraseña desde .NET, con AES-128, AES-256 o el antiguo cifrado Tradicional, también conocido como ZipCrypto. Cada edición es una llamada. Cuál llamada abre el archivo, cómo un archivo corregido reemplaza su entrada anterior, y si la encriptación se establece de nuevo antes de guardar decide el resultado, y una elección equivocada en cualquiera de ellos no genera excepción. El resto de esta página prepara Claude Code para una ingestión de evidencia mensual, con cuatro prompts probados y el comportamiento de IronZIP detrás de cada uno.

Dos configuraciones de modelo cubren la sesión. Sonnet maneja la lista y las reglas del proyecto, y el alias opusplan planea el actualizador con Opus y lo escribe con Sonnet.

Inicio rápido
NuGetInstalar con NuGet

PM > Install-Package IronZip

Instale IronZIP ejecutando el comando arriba en la Consola del Administrador de Paquetes NuGet, o busque el paquete en el Administrador de Paquetes NuGet.

Lanza claude desde la carpeta del repositorio y ejecuta /model sonnet antes de esta solicitud.

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

Se espera que CASE-1043 falle incluso con la contraseña correcta. La sección sobre abrir un ZIP existente explica por qué.



¿Qué hace Claude Code en un proyecto de archivo .NET?

Claude Code escribe el actualizador, construye cada archivo preparado, lo desempaqueta, lee su directorio y lista los chequeos que no pasaron. Después de un chequeo fallido, edita el código y reinicia todo el proceso. Tu parte es definir qué debe contener cada archivo de caso y leer el informe al final.

Nombra IronZIP como la única biblioteca de archivos en el primer prompt. Los atacantes publican paquetes maliciosos bajo nombres que las herramientas de codificación IA alucinan, y un agente que elige su propio paquete puede instalar uno. El ataque se llama slopsquatting.

¿Cómo configuras Claude Code?

El inicio rápido de Anthropic cubre la instalación de Claude Code y cómo iniciar sesión. Una instalación funcional imprime un número de versión para claude --version.

¿Cómo configuras un proyecto en el que Claude Code pueda trabajar?

El repositorio de prueba, CaseArchive, es un proyecto de consola .NET 9 que contiene tres archivos de caso AES-256 en una carpeta de archivos, nuevos archivos para dos de ellos en una carpeta de entrada, y una página Markdown en una carpeta de docs que establece las reglas de ingestión. Se agrega un nuevo nombre de archivo, un nombre coincidente reemplaza su entrada, los nombres listados en remove.txt salen, y un caso sin carpeta de entrada se queda como está. La contraseña del archivo viene de CASE_ARCHIVE_PASSWORD.

Las reglas escritas en CLAUDE.md se cargan al inicio de cada sesión. Con el paquete en su lugar después del Inicio Rápido, la siguiente solicitud escribe ese archivo y un revisor.

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

Una sesión de Claude Code en ejecución no detecta una carpeta .claude/agents recién creada, por lo que compromete esa carpeta, con un archivo de marcador de posición en ella, antes de comenzar.

Configure la licencia antes de la primera apertura. Sin clave, abrir y extraer ambos lanzan LicensingException, y el mensaje dice "Se requiere licencia de producción". La variable IRONZIP_LICENSE_KEY por sí sola no licencia IronZIP. En la prueba de calibración, la variable se estableció y License.IsLicensed se mantuvo falso, por lo que el programa asigna IronZip.License.LicenseKey a partir de ella. La página de Claves de Licencia de IronZIP explica cómo obtener una clave y dónde se puede configurar.

¿Qué reglas de actualización de IronZIP pertenecen a CLAUDE.md?

La prueba de calibración midió cada línea en IronZIP 2026.10.2 contra los archivos de prueba y un archivo de prueba coincidente. Pega el bloque bajo el encabezado Archivos de casos, luego reinicia con claude --continue para que la sesión lo lea.

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

¿Por qué un archivo actualizado pierde su cifrado AES-256?

El guardado vuelve al cifrado Tradicional cuando no se vuelve a establecer el método. En nuestra prueba de calibración, abrir CASE-1044 con su contraseña y guardarlo sin ningún cambio escribió las tres entradas con el cifrado Tradicional. El módulo estándar zipfile de Python, que no puede leer entradas AES, luego descifró cada una de ellas con la contraseña. Llamar a Encrypt con EncryptionMethods.AES256 antes de guardar mantuvo todas las cinco entradas de un CASE-1042 actualizado en AES-256, incluidas las tres nuevas entradas. Un ZipSaveOptions que nombra AES-256, pasado a la llamada de guardado, hizo lo mismo para un archivo con una entrada eliminada.

La extracción con la contraseña tiene éxito de cualquier manera, por lo que solo el directorio bruto muestra el descenso. Cada entrada AES lleva el campo extra 0x9901, cuyo byte de fortaleza es 3 para una clave de 256 bits, y las entradas Tradicionales en la prueba no tenían tal campo.

¿Cómo abres un ZIP existente con IronZIP?

Pasa la ruta y la contraseña al constructor. El ejemplo de añadir archivos a ZIP abre su archivo con FromFile en su lugar, y en la prueba eso produjo un archivo que contiene CASE-1042.zip como una entrada no cifrada junto a la foto añadida. El skill.md de IronZIP advierte que FromFile siempre construye un nuevo archivo y nombra al constructor y FromArchive como las llamadas que abren uno.

Un archivo con una entrada protegida única necesita un método diferente. En las pruebas, un archivo AES-256 de este tipo arrojó "¡Contraseña inválida!" desde el constructor, FromArchive y el constructor de arreglo de bytes, mientras que la extracción con la misma contraseña funcionó. El constructor lanzó el mismo error para un archivo Tradicional con una entrada. La reconstrucción extrae el archivo a una carpeta temporal, copia los archivos de entrada, y guarda un nuevo archivo con Encrypt llamado primero. El CASE-1043 reconstruido tenía tres entradas AES-256 y se abrió normalmente después.

¿Cómo pides código IronZIP que compila?

Ejecuta /model opusplan, luego pulsa Shift+Tab hasta que el modo plan aparezca en la barra de estado, y envía la solicitud.

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

Cada chequeo en el prompt bloquea un falso positivo diferente.

  1. Hash contra las fuentes: se compara una entrada reemplazada con su archivo de entrada, por lo que una declaración que mantuvo su texto antiguo falla.
  2. Análisis del directorio: un nombre duplicado y una entrada faltante también pasan la extracción desapercibidos.
  3. Preparación primero: una actualización que falla un chequeo deja el archivo original tal como estaba.
Consejos: Acepta el plan si llama a Encrypt antes de cada guardado, reconstruye CASE-1043 desde una copia extraída, y no puede almacenar un nombre reemplazado dos veces, ya sea porque elimina la entrada antigua primero o porque construye cada archivo preparado desde cero. Un plan que omite alguno de esos escribe archivos que aún se listan correctamente.

¿Puede una contraseña incorrecta dañar un archivo de caso?

IronZIP lista un archivo protegido por AES abierto con cualquier contraseña, por lo que el primer error llega tarde. En la prueba de calibración, el guardado lanzó ZipException ("Contraseña inválida para AES") y no escribió ningún archivo, y la extracción lanzó ArgumentException ("¡Contraseña inválida!"). El último prompt hace que el agente pruebe que este camino deja los originales sin cambios.

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

¿Qué produjeron los prompts en una ejecución real?

Claude Code recibió los cuatro prompts en orden dentro de una sola sesión, y el bloque de reglas se añadió a CLAUDE.md antes del tercero. Después de la ejecución, el código comprometido se reconstruyó desde un clon limpio y se ejecutó contra los archivos originales. La biblioteca Python pyzipper, que no comparte código con IronZIP, leyó cada resultado.

  • La lista de Inicio Rápido, que Claude Code ejecutó por sí mismo, mostró 4 entradas cifradas para CASE-1042, 3 para CASE-1044 y "¡Contraseña inválida!" para CASE-1043.
  • Después de la ingestión, CASE-1042 tenía 5 entradas en lugar de 4.
  • La actualización de CASE-1042 agregó dos fotos, reemplazó la declaración del testigo y eliminó invoice-7781.pdf.
  • CASE-1043 pasó de 1 entrada a 3.
  • CASE-1044 guardó cada byte.
  • Las 11 entradas en los tres archivos llevaban AES-256.
  • Cada entrada coincidía con el SHA-256 de su archivo fuente.
  • El plan construyó cada archivo preparado desde una copia extraída, incluido el CASE-1043 de una sola entrada, y nunca abrió un archivo para editarlo.
  • El cifrado se ejecutó antes del único guardado del actualizador.
  • El analizador de directorios leyó el nombre de cada entrada y el byte de fortaleza AES y ningún tamaño.
  • Al final del tercer prompt, el subagente auditor de archivos se ejecutó una vez y no reportó ningún miembro de IronZIP no documentado.
  • La reconstrucción limpia pasó ambos casos que tenían archivos de entrada en 2.1 segundos y reportó CASE-1044 como omitido.
  • Las entradas de la reconstrucción coincidieron con las de la ejecución.
  • Con una contraseña incorrecta, los tres casos fallaron en la extracción con "¡Contraseña inválida!".
  • En esa ejecución de contraseña incorrecta, los hashes de los archivos no cambiaron y el proceso salió con el código 1.
  • Antes del cuarto prompt, una contraseña incorrecta detuvo el programa en la primera extracción con una excepción no manejada y sin informe, y los hashes aún coincidían.
  • Algunos pasos se ejecutaron de manera diferente a lo esperado. Cada prompt se envió sin supervisión, como una sesión sin cabeza reanudada, por lo que las elecciones de /model se pasaron como opciones de línea de comandos y cada nuevo prompt recargó CLAUDE.md sin una reinicialización manual. El diálogo del plan no estaba disponible en ese modo, por lo que el plan fue aprobado por una respuesta escrita. La prueba del cuarto prompt se ejecutó como comandos de shell, por lo que el programa no ganó código de subproceso y nunca lee la bandera de subproceso. Durante el cuarto prompt, Claude Code también ejecutó la ingestión una vez con la contraseña correcta, que reescribió CASE-1042 y CASE-1043 con las mismas entradas.

La guía de Cursor también planea antes de cualquier cambio de archivo, y en su ejecución el Modo Plan guardó el puerto IronZIP como un plan Markdown editable. En la guía de ChatGPT Codex, las reglas de ingestión se escriben en AGENTS.md, un archivo que Codex carga antes de que comience cualquier trabajo, donde esta guía usa CLAUDE.md. La guía de asistentes de codificación IA establece una tarea completa de IronZIP con una lista fija de pases, y el registro de ejecución compartido nombra la versión de Claude Code, los modelos, los tiempos de prompt y la máquina de prueba detrás de estos resultados.


Solución de problemas


¿Preguntas?

Si tienes alguna pregunta, contacta a support@ironsoftware.com

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.

Leer más

¿Listo para empezar?

Descargas de NuGet 25,383Versión:2026.11recién lanzado