IronZIPのClaude Codeの使い方
更新された事例アーカイブは、正しいパスワードを使って開き、すべてのファイルをリストし、きれいに抽出することができますが、AES-256ではなく旧ZIP暗号のままで証拠を保持します。ファイルリストには変更は表示されません。 Claude Codeは、Anthropicのコーディングエージェントで、コマンドラインから、VS CodeやJetBrains IDE内、デスクトップアプリとして、またブラウザ内でも利用可能です。 実行される場所に関係なく、リポジトリを読み込んでファイルを編集し、シェルコマンドを実行します。これにより、更新されたアーカイブをステージングし、抽出して生のディレクトリを読み込み、置き換え前にすべてのファイルを比較することができます。
IronZIPは、.NETからパスワード保護されたZIPファイルを開き、編集し、保存します。AES-128、AES-256または、ZipCryptoとも呼ばれる旧暗号に対応しています。 各編集は1つの呼び出しです。 どの呼び出しがアーカイブを開くのか、どのように修正されたファイルが古いエントリを置き換えるのか、そして保存前に暗号化が再設定されるかどうかが結果を決定します。それらのいずれかで誤った選択をすると、例外は発生しません。 このページの残りは、Claude Codeの月次証拠取り込みの準備をし、4つのテストされたプロンプトとそれぞれに関連するIronZIPの動作を示します。
2つのモデル設定がセッションをカバーします。 Sonnetはリストとプロジェクトルールを管理し、opusplanエイリアスはOpusを使用してアップデーターを計画し、Sonnetでそれを書きます。
クイックスタートリポジトリフォルダからclaudeを起動し、このリクエストの前に/model sonnetを実行します。
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.
CASE-1043が正しいパスワードでも失敗することを予測してください。 既存のZIPを開くセクションがその理由を説明しています。
最小限のワークフロー(5ステップ)
- NuGetからC# ZIPライブラリをダウンロード
- リポジトリでClaude Codeを起動し、/modelでモデルを選択します。
- IronZIPの更新ルールをCLAUDE.mdに入れ、編集できないレビューサブエージェントを作成してください。
- アップデーターを計画モードで計画し、各新しいアーカイブをアーカイブフォルダ外でステージングします。
- ステージングされたすべてのアーカイブを抽出し、そのファイルを比較してから元のディレクトリを読み取った後、元を置き換えます。
.NETアーカイブプロジェクトでClaude Codeは何をしますか?
Claude Codeはアップデーターを書き、各ステージされたアーカイブをビルドし、展開してそれのディレクトリを読み取り、合格しなかったチェックをリストします。 チェックに失敗した後、コードを編集し、全体の取り込みを再実行します。 あなたの役割は、すべての事例アーカイブが何を保持すべきかを定義し、最後のレポートを読み取ることです。
最初のプロンプトで唯一のアーカイブラリーとしてIronZIPを指定してください。 攻撃者はAIコーディングツールが幻覚的にメールパッケージを発行し、エージェントが自分のパッケージを選択できる場合、インストールすることができます。 この攻撃はslopsquattingと呼ばれます。
Claude Codeをどのように設定しますか?
Anthropicのクイックスタートは、Claude Codeのインストールとサインインをカバーしています。 作業中のインストールはclaude --versionのバージョン番号を登録します。
プロジェクトClaude Codeが作業できるようにするにはどうすればよいですか?
テストリポジトリCaseArchiveは、アーカイブフォルダに3つのAES-256事例アーカイブ、新しいファイル2つが対応するインカミングフォルダに、そして取り込みルールを設定するMarkdownページがあります。 新しいファイル名が追加され、それに対応する名前がエントリを置き換え、remove.txtにリストされた名前が削除され、それに対応する事例はそのままです。 アーカイブのパスワードはCASE_ARCHIVE_PASSWORDから来ます。
CLAUDE.mdに書かれたルールは、セッションの開始時にロードされます。 パッケージがクイックスタート後に配置された状態で、次のリクエストがそのファイルとレビューを記述します。
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
実行中のClaude Codeセッションは、新規作成された.claude/agentsフォルダを認識しないので、プレースホルダファイルを含むそのフォルダを開始する前にコミットしてください。
最初に開く前にライセンスを設定してください。 キーがない場合、開くと抽出の両方がLicensingExceptionをスローし、メッセージは「Production License Required」と言います。 IRONZIP_LICENSE_KEY変数だけではIronZIPをライセンス化しません。校正プローブでは変数が設定され、License.IsLicensedはfalseのままでした。そのためプログラムはIronZip.License.LicenseKeyをそこから割り当てます。 IronZIPライセンスキーページでは、キーの取得方法と設定場所を説明しています。
CLAUDE.mdに含めるべきIronZIPの更新ルールはどれですか?
校正プローブは、IronZIP 2026.10.2の各行をフィクスチャアーカイブおよび対応するプローブアーカイブと比較して測定しました。Case archivesの見出しの下にそれを貼り付け、セッションがそれを読み取るようにclaude --continueで再起動します。
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.
なぜ更新されたアーカイブはAES-256暗号化を失うのですか?
保存がメソッドを再設定せずに、旧暗号にフォールバックします。 校正プローブでは、CASE-1044をそのパスワードで開き、まったく変更せずに保存すると、3つすべてのエントリが旧暗号で書き込まれました。 その後、Pythonの標準zipfileモジュール(AESエントリを読み取れない)がパスワードでそれらをすべて解読しました。 保存の前にEncryptionMethods.AES256でEncryptを呼び出すと、更新されたCASE-1042の5つのエントリすべてをAES-256で保持しました。新しい3つのエントリを含みます。 AES-256を指定したZipSaveOptionsが保存呼び出しに渡され、1つのエントリが削除されたアーカイブにも同じようにしました。
いずれの場合もパスワードでの抽出は成功するため、未加工のディレクトリだけがダウングレードを示します。 各AESエントリには追加フィールド0x9901が含まれており、強度バイトは256ビットキーには3です。プローブの旧エントリにはそのようなフィールドはありませんでした。
IronZIPで既存のZIPをどのように開きますか?
パスとパスワードをコンストラクタに渡します。 ZIPにファイルを追加する例は代わりにFromFileでアーカイブを開き、プローブでは追加した写真の横に暗号化されていないCASE-1042.zipを1つのエントリとして保持するアーカイブを生成しました。 IronZIPのskill.mdは、FromFileが常に新しいアーカイブを構築することを警告し、それを開く呼び出しとしてコンストラクタとFromArchiveを名指ししています。
単一の保護されたエントリを持つアーカイブは別の方法を必要とします。 プローブでは、この種のAES-256アーカイブがコンストラクタ、FromArchive、およびバイト配列コンストラクタから「無効なパスワード!」をスローしましたが、同じパスワードでの抽出は成功しました。 コンストラクタは1つのエントリを持つ伝統的なアーカイブについても同じエラーをスローしました。 リビルドはアーカイブを一時フォルダに抽出し、インカミングファイルをコピーし、最初にEncryptを呼び出して新しいアーカイブを保存します。リビルドされたCASE-1043は3のAES-256エントリを保持し、その後通常通り開きました。
コンパイルされるIronZIPコードをどのようにプロンプトしますか?
/model opusplanを実行し、ステータスバーにプランモードが表示されるまでShift+Tabをサイクルし、リクエストを送信します。
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/.
プロンプトの各チェックは異なる誤った通過をブロックします。
- ソースに対するハッシュ:置き換えられたエントリはそのインカミングファイルと比較されるため、古いテキストを保持したステートメントは失敗します。
- ディレクトリパース:重複した名前と欠落したエントリも抜き出されずに通過します。
- 最初にステージング:チェックに失敗した更新は元のアーカイブをそのまま残します。
Encryptを呼び出し、抽出したコピーからCASE-1043をリビルドし、置き換えられた名前を2回保存できない場合、つまり、最初に古いエントリーを削除するか、各ステージアーカイブをゼロから作成している場合は、プランを承認してください。 それらのいずれかを欠如したプランは、まだ正しくリストされているアーカイブを書きます。間違ったパスワードが事例アーカイブを損傷することはありますか?
IronZIPは、任意のパスワードで開かれたAES保護アーカイブをリストするので、最初のエラーは遅れてきます。 校正プローブでは、保存でZipException(「AESの無効なパスワード」)をスローし、ファイルを書き込まず、抽出でArgumentException(「無効なパスワード!!」)をスローしました。 最後のプロンプトは、この経路がオリジナルを変更せずに残すことをエージェントに証明させます。
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.
プロンプトが実運用で生成したものは何ですか?
Claude Codeは単一のセッション内で順番に4つのプロンプトを受け取り、3番目の前にCLAUDE.mdにルールブロックが追加されました。 実行後、コミットされたコードはクリーンなクローンから再ビルドされ、オリジナルアーカイブに対して実行されました。 IronZIPとコードを共有しないPythonライブラリpyzipperはすべての結果を読みました。
- クイックスタートのリストは、Claude Code自身が実行し、CASE-1042に4つの暗号化エントリ、CASE-1044に3つ、「無効なパスワード!」でCASE-1043を示しました。
- 取り込み後、CASE-1042は4つではなく5つのエントリを保持していました。
- CASE-1042の更新で2つの写真を追加し、目撃者の証言を置き換え、invoice-7781.pdfを削除しました。
- CASE-1043は1つのエントリから3つに増えました。
- CASE-1044はすべてのバイトを保持しました。
- 3つのアーカイブの11のエントリすべてがAES-256を使用していました。
- 各エントリはそのソースファイルのSHA-256と一致しました。
- プランは抽出されたコピーから各ステージアーカイブを作成し、単一エントリのCASE-1043を含み、アーカイブを開いて編集することはありませんでした。
- アップデーターの唯一の保存前にEncryptが走りました。
- ディレクトリパーサーは各エントリの名前とAES強度バイトを読み取り、サイズは読み取りませんでした。
- 3番目のプロンプトの最後で、アーカイブ監査サブエージェントが1回実行され、未文書のIronZIPメンバーを報告しませんでした。
- クリーンな再ビルドは、2.1秒で入ってきたファイルがあった両方のケースを通過し、CASE-1044をスキップされたと報告しました。
- 再ビルドからのエントリは実行からのそれらと一致しました。
- 間違ったパスワードで、3つのケースで「無効なパスワード!!」と表示され、抽出に失敗しました。
- その間違ったパスワードでの実行では、アーカイブのハッシュは変わらず、プロセスはコード1で終了しました。
- 4つ目のプロンプトの前に、間違ったパスワードが最初の抽出でプログラムを未処理の例外で停止し、レポートなしでプログラムを停止し、ハッシュは一致しました。
- 一部のステップはページと異なる方法で実行されました。 各プロンプトは放置されたままで送られ、再開されたヘッドレスセッションのために、/modelの選択肢はコマンドラインオプションとして渡され、各新しいプロンプトは手動で再起動せずにCLAUDE.mdをリロードしました。 そのモードではプランダイアログは利用できなかったため、プランは入力された返信によって承認されました。 4つ目のプロンプトの証明はシェルコマンドとして実行され、そのためプログラムは子プロセスコードを取得せず、子フラグを読み取りませんでした。 4つ目のプロンプトの間に、Claude Codeは正しいパスワードで取込みを一度実行し、その結果CASE-1042とCASE-1043が同じエントリで書き直されました。
Cursorガイドも、ファイルの変更前に計画し、その実行でPlan ModeはIronZIPポートを編集可能なMarkdownプランとして保存しました。 ChatGPT Codexガイドでは、取り込みルールはAGENTS.mdに書き込まれ、Codexが作業を始める前にそのファイルをロードします。このガイドではCLAUDE.mdを使用します。 AIコーディングアシスタントガイドは固定パススリストを持つ1つの完全なIronZIPタスクを設定し、共有ランレコードはClaude Codeのバージョン、モデル、プロンプトタイミング、これらの結果の背後にあるテストマシンを名指しします。
トラブルシューティング
- 最初のアーカイブを開くときにライセンス例外をスローする場合はIronZIPライセンスキー
- 保護されたアーカイブがそのパスワードを拒否した場合は保護されたZIPへのアクセス
- ケースアーカイブがクラシックZIPリミットを超えて成長した場合はIronZIPファイルとアーカイブサイズの制限
質問ありますか?
質問がある場合は、support@ironsoftware.com にお問い合わせください。
Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。