Como usar IronZIP com Claude Code

Curtis Chau
Curtis Chau
Atualizado: 26 de outubro de 2026

Um arquivo de caso que passou por uma atualização pode abrir com a senha correta, listar cada arquivo e extrair corretamente, e ainda manter sua evidência sob a antiga cifra ZIP em vez de AES-256. Nada na lista de arquivos mostra a alteração. Claude Code é o agente de codificação da Anthropic, disponível na linha de comando, dentro do VS Code e IDEs JetBrains, como um aplicativo de desktop e em um navegador. Onde quer que seja executado, ele lê o repositório, edita arquivos e executa comandos de shell, o que permite preparar um arquivo de atualização, extrair, ler seu diretório bruto e comparar cada arquivo antes que o original seja substituído.

IronZIP abre, edita e salva arquivos ZIP protegidos por senha do .NET, com AES-128, AES-256 ou a cifra tradicional mais antiga, também conhecida como ZipCrypto. Cada edição é uma chamada. Qual chamada abre o arquivo, como um arquivo corrigido substitui sua entrada antiga e se a criptografia é configurada novamente antes da gravação determina o resultado, e uma escolha errada em qualquer deles não gera exceção. O restante desta página prepara Claude Code para uma entrada de evidências mensal, com quatro prompts testados e o comportamento do IronZIP por trás de cada um.

Duas configurações de modelo cobrem a sessão. Sonnet lida com a listagem e as regras do projeto, e o alias opusplan planeja o atualizador com Opus e escreve com Sonnet.

Início Rápido
NuGetInstalar com NuGet

PM > Install-Package IronZip

Instale o IronZIP executando o comando acima no Console do Gerenciador de Pacotes NuGet, ou procure pelo pacote no Gerenciador de Pacotes NuGet.

Inicie claude a partir da pasta do repositório e execute /model sonnet antes deste pedido.

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

Espere que CASE-1043 falhe, mesmo com a senha correta. A seção sobre abertura de um ZIP existente explica o porquê.



O que faz Claude Code em um projeto de arquivo .NET?

Claude Code escreve o atualizador, constrói cada arquivo preparado, desempacota-o, lê seu diretório e lista os cheques que não passaram. Após uma falha no cheque, edita o código e executa novamente toda a entrada. Sua parte é definir o que cada arquivo de caso deve conter e ler o relatório no final.

Nomeie IronZIP como a única biblioteca de arquivos no primeiro prompt. Os atacantes publicam pacotes maliciosos sob nomes que ferramentas de codificação de IA imaginam, e um agente que escolhe seu próprio pacote pode instalar um. O ataque é chamado de slopsquatting.

Como você configura o Claude Code?

O começo rápido da Anthropic cobre a instalação de Claude Code e o login. Uma instalação funcional imprime um número de versão para claude --version.

Como você configura um projeto no qual o Claude Code possa trabalhar?

O repositório de teste, CaseArchive, é um projeto de console .NET 9 que contém três arquivos de caso AES-256 em uma pasta de arquivos, novos arquivos para dois deles em uma pasta de entrada e uma página Markdown em uma pasta de documentos que define as regras de entrada. Um novo nome de arquivo é adicionado, um nome correspondente substitui sua entrada, nomes listados em remove.txt são removidos, e um caso sem pasta de entrada permanece como está. A senha do arquivo vem de CASE_ARCHIVE_PASSWORD.

Regras escritas em CLAUDE.md carregam no início de cada sessão. Com o pacote no lugar após o Início Rápido, o próximo pedido escreve esse arquivo e um 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

Uma sessão em execução do Claude Code não detecta uma nova pasta .claude/agents, então você deve confirmar essa pasta, com um arquivo substituto nela, antes de começar.

Configurar a licença antes da primeira abertura. Sem chave, abrir e extrair ambos lançam LicensingException, e a mensagem diz "Licença de Produção Necessária". A variável IRONZIP_LICENSE_KEY por si só não licencia o IronZIP. Na sonda de calibração, a variável foi definida, e License.IsLicensed permaneceu falso, então o programa atribui IronZip.License.LicenseKey a partir dele. A página de Chaves de Licença IronZIP explica como obter uma chave e onde ela pode ser configurada.

Quais regras de atualização do IronZIP pertencem ao CLAUDE.md?

A sonda de calibração mediu cada linha no IronZIP 2026.10.2 contra os arquivos de teste e um arquivo de sonda correspondente. Cole o bloco sob a seção de arquivos de caso, então reinicie com claude --continue para que a sessão o leia.

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 que um arquivo atualizado perde sua criptografia AES-256?

A gravação reverte para a cifra Tradicional quando nada define o método novamente. Na nossa sonda de calibração, abrir CASE-1044 com sua senha e salvá-lo sem nenhuma alteração escreveu todas as três entradas com a cifra Tradicional. O módulo padrão zipfile de Python, que não pode ler entradas AES, então decifrou todas elas com a senha. Chamar Encrypt com EncryptionMethods.AES256 antes da gravação manteve todas as cinco entradas de um CASE-1042 atualizado no AES-256, incluindo as três novas entradas. Um ZipSaveOptions que nomeia AES-256, passado para a chamada save, fez o mesmo para um arquivo com uma entrada excluída.

A extração com a senha é bem-sucedida de qualquer maneira, então apenas o diretório bruto mostra o downgrade. Cada entrada AES carrega o campo extra 0x9901, cujo byte de força é 3 para uma chave de 256 bits, e as entradas Tradicionais na sonda não tinham esse campo.

Como você abre um ZIP existente com IronZIP?

Passe o caminho e a senha para o construtor. O exemplo de adicionar arquivos ao ZIP abre seu arquivo com FromFile em vez disso, e na sonda que produziu um arquivo contendo CASE-1042.zip como uma entrada não criptografada ao lado da foto adicionada. O skill.md do IronZIP avisa que FromFile sempre cria um novo arquivo e nomeia o construtor e FromArchive como as chamadas que abrem um.

Um arquivo com uma única entrada protegida precisa de um método diferente. Nas sondas, um arquivo AES-256 desse tipo lançou "Senha Inválida!" do construtor, FromArchive e do construtor da matriz de bytes, enquanto a extração com a mesma senha funcionou. O construtor lançou o mesmo erro para um arquivo Tradicional com uma entrada. A reconstrução extrai o arquivo para uma pasta temporária, copia os arquivos de entrada, e salva um novo arquivo com Encrypt chamado primeiro. O reconstruído CASE-1043 tinha três entradas AES-256 e abriu normalmente depois.

Como você solicita um código IronZIP que compila?

Execute /model opusplan, então ciclíe Shift+Tab até que o modo de planejamento apareça na barra de status, e envie o pedido.

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 verificação no prompt bloqueia uma passagem falsa diferente.

  1. Hashes contra as fontes: uma entrada substituída é comparada com seu arquivo de entrada, então uma declaração que manteve seu texto antigo falha.
  2. Análise do diretório: um nome duplicado e uma entrada ausente também passam a extração despercebidos.
  3. Preparação primeiro: uma atualização que falha em uma verificação deixa o arquivo original como estava.
Dicas: Aceite o plano se ele chamar Encrypt antes de cada gravação, reconstruir CASE-1043 de uma cópia extraída, e não puder armazenar um nome substituído duas vezes, seja porque exclui a entrada antiga primeiro ou porque cria cada arquivo preparado do zero. Um plano que perde qualquer um desses escreve arquivos que ainda listam corretamente.

Uma senha errada pode danificar um arquivo de caso?

IronZIP lista um arquivo protegido por AES aberto com qualquer senha, então o primeiro erro vem tarde. Na sonda de calibração, a gravação lançou ZipException ("Senha inválida para AES") e não escreveu nenhum arquivo, e a extração lançou ArgumentException ("Senha inválida!!"). O último prompt faz o agente provar que esse caminho deixa os originais inalterados.

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

O que os prompts produziram em uma execução real?

Claude Code recebeu os quatro prompts em ordem dentro de uma única sessão, e o bloco de regras foi anexado ao CLAUDE.md antes do terceiro. Após a execução, o código comprometido foi reconstruído de um clone limpo e executado contra os arquivos originais. A biblioteca Python pyzipper, que não compartilha código com IronZIP, leu todos os resultados.

  • A lista do início rápido, que Claude Code executou por si próprio, mostrou 4 entradas criptografadas para CASE-1042, 3 para CASE-1044 e "Senha Inválida!" para CASE-1043.
  • Após a entrada, CASE-1042 continha 5 entradas em vez de 4.
  • A atualização CASE-1042 adicionou duas fotos, substituiu a declaração da testemunha e removeu invoice-7781.pdf.
  • CASE-1043 passou de 1 entrada para 3.
  • CASE-1044 manteve cada byte.
  • Todas as 11 entradas nos três arquivos carregavam AES-256.
  • Cada entrada correspondia ao SHA-256 de seu arquivo de origem.
  • O plano construiu cada arquivo preparado de uma cópia extraída, incluindo o CASE-1043 de entrada única, e nunca abriu um arquivo para editá-lo.
  • A criptografia foi executada antes da única gravação do atualizador.
  • O analisador de diretórios leu o nome de cada entrada e o byte de força AES e não os tamanhos.
  • No final do terceiro prompt, o subagente de auditoria de arquivos foi executado uma vez e não relatou nenhum membro IronZIP não documentado.
  • A reconstrução limpa passou ambos os casos que tinham arquivos de entrada em 2,1 segundos e relatou CASE-1044 como pulado.
  • Entradas da reconstrução corresponderam às da execução.
  • Com uma senha errada, todos os três casos falharam na extração com "Senha inválida!!".
  • Naquela execução de senha errada, os hashes do arquivo não mudaram e o processo terminou com o código 1.
  • Antes do quarto prompt, uma senha errada interrompeu o programa na primeira extração com uma exceção não tratada e sem relatório, e os hashes ainda corresponderam.
  • Alguns passos foram executados de forma diferente da página. Cada prompt foi enviado sem supervisão, como uma sessão resumida sem cabeça, então as escolhas /model foram passadas como opções de linha de comando e cada novo prompt recarregou CLAUDE.md sem um reinício manual. O diálogo do plano não estava disponível nesse modo, então o plano foi aprovado por uma resposta digitada. A prova do quarto prompt foi executada como comandos de shell, então o programa não ganhou código de processo filho e nunca lê a bandeira filha. Durante o quarto prompt, Claude Code também executou a entrada uma vez com a senha correta, o que reescreveu CASE-1042 e CASE-1043 com as mesmas entradas.

O guia do Cursor também planeja antes de qualquer alteração de arquivo, e em sua execução, o Modo de Planejamento salvou a porta IronZIP como um plano Markdown editável. No guia Codex ChatGPT, as regras de entrada são escritas para AGENTS.md, um arquivo que o Codex carrega antes de qualquer trabalho começar, onde este guia usa CLAUDE.md. O guia de assistentes de codificação de IA define uma tarefa completa do IronZIP com uma lista de passagens fixa, e o compartilhado registro de execução nomeia a versão do Claude Code, os modelos, os tempos de prompt e a máquina de teste por trás desses resultados.


Solução de problemas


Questões?

Se você tiver dúvidas, entre em contato com support@ironsoftware.com

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.

Leia Mais

Pronto para começar?

Downloads no NuGet 25,383Versão:2026.11recém-lançado