IronZIP'i Claude Code ile Nasıl Kullanılır

Curtis Chau
Curtis Chau
Güncellendi: 26 Ekim 2026

Güncellenmiş bir vaka arşivi, doğru şifre ile açılabilir, her dosyayı listeleyebilir ve sorunsuzca çıkarabilir, ve yine de AES-256 yerine eski ZIP şifresi altında delillerini barındırabilir. Dosya listesinde değişiklik gösterilmez. Claude Code, Anthropic'in kodlama aracıdır; komut satırından, VS Code ve JetBrains IDE'lerinin içinde, masaüstü uygulaması olarak ve tarayıcıda mevcuttur. Nerede çalışıyorsa, deposunu okur, dosyaları düzenler ve kabuk komutlarını çalıştırır; bu da onun güncellenmiş bir arşivi sahnelemesine, çıkarmasına, ham dizini okumasına ve orijinalinin yerini almadan önce her dosyayı karşılaştırmasına olanak tanır.

IronZIP, .NET'ten parolayla korunan ZIP dosyalarını açar, düzenler ve kaydeder; AES-128, AES-256 veya ZipCrypto olarak da bilinen eski Geleneksel şifreleme yöntemlerini kullanır. Her düzenleme bir çağrıdır. Arşivi hangi çağrı açar, düzeltilmiş bir dosya eski girişini nasıl değiştirir ve kurtarma öncesinde şifreleme tekrar ayarlanıp ayarlanmadığı sonucu belirler ve bunlardan herhangi birinde yanlış bir seçim istisna yükseltmez. Bu sayfanın geri kalan kısmı, dört test edilmiş istem ve her bir yönetim için IronZIP davranışı ile birlikte Claude Code'u aylık delil alımı için hazırlar.

İki model ayarı oturumu kapsar. Sonnet listeleme ve proje kurallarını yönetir ve opusplan öz takma adı, Opus ile güncelleyiciyi planlar ve Sonnet ile yazar.

Hızlı Başlangıç
NuGetNuGet ile Yükle

PM > Install-Package IronZip

Yukarıdaki komutu NuGet Paket Yöneticisi Konsolunda çalıştırarak veya NuGet Paket Yöneticisinde arama yaparak IronZIP'u yükleyin.

Bu isteği göndermeden önce depo klasöründen claude çalıştırın ve /model sonnet çalıştırın.

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

CASE-1043'ün doğru şifre bile varsa başarısız olmasını bekleyin. Mevcut bir ZIP'in nasıl açıldığını açıklayan bölüm, nedenini açıklar.



.NET arşiv projesinde Claude Code ne yapar?

Claude Code güncelleyiciyi yazar, her sahnelenmiş arşivi oluşturur, paketini açar, dizinini okur ve geçmeyen kontrolleri listeler. Başarısız bir kontrolden sonra kodu düzenler ve tüm alımı tekrar çalıştırır. Sizin göreviniz, her vaka arşivinin ne taşıması gerektiğini tanımlamak ve sonunda raporu okumaktır.

İlk istemde tek arşiv kütüphanesi olarak IronZIP'i adıyla belirtin. Saldırganlar, AI kodlama araçlarının hayal ettiği adlar altında kötü niyetli paketler yayımlar ve kendi paketini seçen bir ajan birini yükleyebilir. Saldırıya slopsquatting adı verilir.

Claude Code nasıl kurulur?

Anthropic'in hızlı başlangıç kılavuzu Claude Code'u kurmayı ve oturum açmayı kapsar. Çalışan bir kurulum, claude --version için bir sürüm numarasını yazdırır.

Claude Code'un çalışabileceği bir proje nasıl kurulur?

Test deposu CaseArchive, bir arşivler klasöründe üç AES-256 vaka arşivi, iki tanesi için yeni dosyalar bir gelen klasörü ve alma kurallarını belirleyen bir Markdown sayfası barındıran .NET 9 konsol projesidir. Yeni bir dosya adı eklenir, eşleşen bir ad girişini değiştirir, remove.txt'de listelenen adlar çıkarılır ve gelen klasörü olmayan bir vaka olduğu gibi kalır. Arşiv şifresi CASE_ARCHIVE_PASSWORD'ten gelir.

CLAUDE.md'de yazılı kurallar her oturumun başında yüklenir. Hızlı Başlangıç'tan sonra paket yerleştirildikten sonra, bir sonraki istek o dosyayı ve bir incelemeyi yazar.

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

Çalışan bir Claude Code oturumu, yeni oluşturulan .claude/agents klasörünü algılamaz; bu yüzden başlamadan önce, içinde bir yer tutucu dosyayla, bu klasörü ekleyin.

İlk açılmadan önce lisansı ayarlayın. Anahtarsız bir şekilde açmak ve çıkarmak her ikisi de LicensingException fırlatır ve mesaj 'Üretim Lisansı Gerekli' der. IRONZIP_LICENSE_KEY değişkeni tek başına IronZIP'i lisanslamaz. Kalibrasyon probunda değişken ayarlandı ve License.IsLicensed false kaldı, bu yüzden program ondan IronZip.License.LicenseKey atar. IronZIP Lisans Anahtarları sayfası, bir anahtarın nasıl alınacağını ve nerede ayarlanabileceğini açıklar.

Hangi IronZIP güncelleme kuralları CLAUDE.md'ye ait?

Kalibrasyon probu, IronZIP 2026.10.2 üzerindeki her satırı sabit arşivler ve eşleşen bir prob arşiviyle ölçtü. Case Archives başlığının altına bloğu yapıştırın, ardından oturumun onu okuması için claude --continue ile yeniden başlatın.

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

Neden bir güncellenmiş arşiv AES-256 şifrelemesini kaybeder?

Yeni bir yöntem ayarlamadan kaydetme işlemi Geleneksel şifrelemeye geri döner. Kalibrasyon probumuzda, CASE-1044 şifresi ile açıldığında ve değişiklik yapılmadan kaydedildiğinde tüm üç girişi Geleneksel şifreleme ile yazıldı. Python'nun standart zipfile modülü sonrasında, AES girişlerini okuyamayan şifreyi her birini bu şifre ile şifrelerini çözdü. Saklama öncesinde Encrypt ile EncryptionMethods.AES256 çağrısı, CASE-1042'nin güncellenmiş beş girişi, üç yeni girişi dahil, AES-256 olarak korudu. AES-256'yı adlandıran bir ZipSaveOptions, kaydetme çağrısına iletilmiş, silinmiş bir giriş olan bir arşivde aynısını yaptı.

Şifreyle çıkarılması her iki şekilde de başarılı olur, bu nedenle yalnızca ham dizin gerileme gösterir. Her bir AES girişi, 256-bit anahtar için güç byte'ı 3 olan ekstra alan 0x9901 taşıyor ve probdaki Geleneksel girişlerde böyle bir alan yoktu.

Mevcut bir ZIP'i IronZIP ile nasıl açarsınız?

Yolu ve şifreyi yapıcıya iletin. ZIP örneğine dosya ekleme örneği arşivini bunun yerine FromFile ile açar ve CASE-1042.zip'i eklenmiş fotoğrafın yanında şifrelenmemiş bir giriş olarak barındıran bir arşiv üreten probda. IronZIP'in skill.md dosyası, FromFile her zaman yeni bir arşiv oluşturduğunu ve yapıcı ile FromArchive çağrılarını birini açan çağrılar olarak adlandırır.

Tek korumalı bir girişe sahip bir arşiv için başka bir yöntem gereklidir. Problarda, bu tür bir AES-256 arşivi, yapıcıdan, FromArchive ve byte dizi yapıcısından 'Geçersiz Şifre!' fırlattı, aynı şifre ile çıkarma çalıştı. Yapıcı, bir girişe sahip Geleneksel bir arşivde aynı hatayı fırlattı. Yeniden inşa, arşivi geçici bir klasöre çıkarır, gelen dosyaları kopyalar ve önce Encrypt çağrılan yeni bir arşiv kaydeder. Yeniden inşa edilen CASE-1043, üç AES-256 girişini içerdi ve ardından normal olarak açıldı.

Derlenen IronZIP kodu için nasıl istemde bulunursunuz?

/model opusplan çalıştırın, ardından plan modu durum çubuğunda görününceye kadar Shift+Tab döngüsü yapın ve isteği gönderin.

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

Her istemdeki kontrol farklı bir yanlış geçişi engeller.

  1. Kaynaklara karşı hashler: yeni bir giriş, gelen dosyasıyla karşılaştırılır, bu nedenle eski metnini koruyan bir ek beyanı başarısız olur.
  2. Dizin analizi: çifte ad ve eksik bir giriş çıkarma sırasında fark edilmez.
  3. İlk olarak sahneleme: bir kontrolü geçemeyen bir güncelleme, orijinal arşivi olduğu gibi bırakır.
İpuçları: Plan, her kayıttan önce Encrypt çağrısını yapıyorsa, CASE-1043'u çıkarılmış bir kopyadan yeniden inşa ediyorsa ve eski girdiyi ilk önce sildiği için veya her sahne toplanmış arşivi baştan oluşturduğu için değiştirilen bir ismi iki kez saklayamıyorsa kabul edin. Bu yazılardan herhangi birinin eksik olduğu bir plan, hala doğru şekilde listelenen arşivleri oluşturur.

Yanlış bir şifre bir vaka arşivine zarar verebilir mi?

Herhangi bir şifreyle açılmış bir AES tarafından korunan arşivi IronZIP listeler, bu yüzden ilk hata geç gelir. Kalibrasyon probunda, kayıt ZipException ('AES için geçersiz şifre') fırlattı ve herhangi bir dosya yazmadı; çıkarma ise ArgumentException ('Geçersiz şifre!') fırlattı. Son istem, bu yolun orijinal dosyaları değiştirilmeden bıraktığını ispat eder.

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

Gerçek bir çalıştırmada istemler ne üretti?

Claude Code, bir oturum içinde dört istemi sırayla aldı ve kural bloğu üçüncüsünden önce CLAUDE.md'ye eklenmişti. Çalıştırmadan sonra, taahhüt edilen kod temiz bir kopyadan yeniden inşa edildi ve orijinal arşivlere karşı çalıştırıldı. Python kütüphanesi pyzipper, IronZIP ile hiçbir kod paylaşmaz, her sonucu okudu.

  • Claude Code'un kendisinin çalıştırdığı Hızlı Başlangıç listesi, CASE-1042 için 4 şifreli giriş, CASE-1044 için 3 ve CASE-1043 için 'Geçersiz Şifre!' gösterdi.
  • Alımdan sonra, CASE-1042 4 yerine 5 giriş içerdi.
  • CASE-1042 güncellemesi, iki fotoğraf ekledi, tanık ifadesini değiştirdi ve invoice-7781.pdf'i kaldırdı.
  • CASE-1043 1 girişten 3'e çıktı.
  • CASE-1044 her byte'ı korudu.
  • Üç arşivdeki tüm 11 giriş AES-256 içeriyordu.
  • Her giriş, kaynak dosyasının SHA-256'sı ile eşleşti.
  • Plan, her sahnelenmiş arşivi çıkarılmış bir kopyadan oluşturdu, tek girişli CASE-1043 dahil, ve onu düzenlemek için hiçbir arşiv açmadı.
  • Şifreleme, güncelleyicinin tek kaydından önce çalıştı.
  • Dizin analizi, her girişin adını ve AES güç byte'ını okudu, ancak boyutları okumadı.
  • Üçüncü istemin sonunda, arşiv denetçisi alt ajan bir kez çalıştı ve belgelenmemiş IronZIP üyesi rapor etmedi.
  • Temiz yeniden inşa, gelen dosyaları olan iki vakadan her ikisini de 2,1 saniyede geçirdi ve CASE-1044'ün atlandığını bildirdi.
  • Yeniden yapılandırmadan alınan girişler, çalıştırmadan alınanlarla eşleşti.
  • Yanlış bir şifreyle, üç vaka da çıkarma sırasında 'Geçersiz şifre!' ile başarısız oldu.
  • Bu yanlış şifre çalıştırmasında, arşiv hash'leri değişmedi ve süreç kod 1 ile sonlandı.
  • Dördüncü istemden önce, yanlış şifre, programı bir rapor ve ele alınmamış bir istisna olmadan ilk çıkarma esnasında durdurdu, ve hash'ler hala eşleşti.
  • Bazı adımlar sayfadan farklı çalıştı. Her istem, başsız yeniden başlatılan bir oturum olarak gözetimsiz gönderildi, bu yüzden /model seçenekleri komut satırı seçenekleri olarak geçirildi ve her yeni istem CLAUDE.md'yi manuel yeniden başlatma olmadan yeniden yükledi. Plan diyaloğu bu modda mevcut olmadığından, plan yazılı bir yanıtla onaylandı. Dördüncü istemin kanıtı kabuk komutları olarak çalıştı, bu yüzden program çocuk süreç kodu kazanmadı ve asla çocuk bayrağını okumadı. Dördüncü istem esnasında, Claude Code ayrıca alımı doğru şifre ile bir kez çalıştırdı, bu da CASE-1042 ve CASE-1043'ü aynı girişlerle tekrar yazdı.

Cursor kılavuzu da herhangi bir dosya değişikliğinden önce planlar yapar ve çalıştırmasında Plan Modu, IronZIP bağlantı noktasını düzenlenebilir bir Markdown planı olarak kaydetti. ChatGPT Codex kılavuzunda, alma kuralları işin başladığı her zaman AGENTS.md'ye yazılır, bu kılavuz CLAUDE.md'yi kullanırken. AI kodlama yardımcıları kılavuzu, sabit bir geçiş listesi ile bir tam IronZIP görevi ayarlar ve paylaşılan çalıştırma kaydı, Claude Code sürümünü, modelleri, istem sürelerini ve bu sonuçların arkalarındaki test makinesini adlandırır.


Hata Ayıklama


Sorular?

Herhangi bir sorunuz varsa, support@ironsoftware.com adresinden bize ulaşın

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.

Daha Fazla Oku

Başlamaya Hazır mısınız?

NuGet İndirmeleri 25,383Sürüm:2026.11yeni çıktı