IronZIP를 ChatGPT Codex와 함께 사용하는 방법

Curtis Chau
Curtis Chau
업데이트됨: 2026년 10월 26일

파트너들은 그들 시스템에서 생성하는 어떤 형식으로든 그날 밤의 파일을 전송합니다. 하나의 드롭은 비밀번호가 있는 ZIP 파일과 없는 파일, Linux 호스트에서 받은 TAR 및 TGZ 번들, BZIP2 주식 번들, 실제로는 ZIP인 .tar라는 파일, 그리고 중간에 중지된 업로드를 포함합니다. 입력 프로세스는 각각을 풀어야 하고, 각 파일이 파트너가 보낸 그대로 도착했는지 입증하며, 어떤 업로드가 실패했는지와 그 이유를 알려야 합니다.

ChatGPT Codex는 OpenAI의 코딩 에이전트로, 터미널, 에디터, ChatGPT 데스크톱 앱 내부 및 클라우드 서비스에서 실행되며, 이들 모두 ChatGPT 로그인 수용합니다. IronZIP는 ZIP, TAR, GZIP 및 BZIP2 아카이브를 읽고 쓰기 위한 Iron Software의 .NET 라이브러리입니다.

이 가이드는 Codex에 25개의 업로드, 각각의 상태를 나타내는 매니페스트 및 각 파트너로부터의 SHA-256 목록을 제공합니다. 대부분의 프롬프트는 Codex에 각 파일에 대해 하나의 행이 있는 CSV 생성을 요청하며, 아래 설명된 모든 IronZIP 행동은 버전 2026.10.2에서 측정되었습니다.

빠른 시작
NuGetNuGet으로 설치

PM > Install-Package IronZip

위 명령을 NuGet 패키지 관리자 콘솔에 입력하거나 NuGet 패키지 관리자에서 패키지를 검색하여 IronZIP를 설치하십시오.

.NET 콘솔 프로젝트에서 Codex를 실행하고 먼저 목록을 요청하십시오.

$ironzip Add IronZIP 2026.10.2 from NuGet to this console project.
Next, Program.cs opens every file in Drop/sample/ with IronZipArchive, read-only.

out/quickstart.csv gets one row per file, holding these values:

- entry count
- encrypted entry count
- the exception type when IronZIP refuses the file

Read that CSV back and print its totals.
Assign the key from IRONZIP_LICENSE_KEY and never print it.
Extract nothing yet.
Build and run it with three repair attempts at most, then report what happened.
Text


ChatGPT Codex란 무엇이며, .NET 아카이브 작업에 어떻게 적합한가요?

Codex CLI 페이지는 npm install -g @openai/codex 또는 독립 설치 프로그램으로 설치를 다루며, IDE 페이지는 에디터를 다룹니다.

OpenAI의 보안 지침은 Codex 제안을 다른 풀 요청처럼 처리하고, 타겟화된 확인과 차이 검토를 요구합니다. 존재하지 않는 멤버는 빌드를 실패하게 하며, 잘못 처리된 아카이브는 매니페스트와 상충하는 상태로 표시됩니다.

IronZIP 프롬프트를 작성하고 Codex를 설정하는 방법은?

입력 프롬프트는 입력, 형식 규칙, 출력 폴더, 체크섬 증명, 비밀번호 소스 및 읽기 전용 폴더를 명명합니다. 생략된 모든 부분은 에이전트가 대신 결정합니다.

Codex는 작업 디렉터리 및 저장소 루트까지의 각 상위 폴더에서 .agents/skills를 스캔합니다. IronZIP의 skill.md는 .agents/skills/IronZIP/SKILL.md로 저장되며, $ironzip 해결을 돕습니다. 그 예들은 2026.8.2를 고정하며, 아래에 측정된 TAR 폴더 실패나 단일 항목 비밀번호 실패는 언급하지 않습니다.

Codex는 모든 실행의 시작에서 AGENTS.md를 읽으며, 작업 폴더 경로에서 프로젝트 루트까지의 경로당 최대 하나의 파일을 읽습니다. 작업 폴더에 가까운 파일이 이전 파일을 덮어씁니다. IronZIP의 llms.txt 인덱스는 두 번째 API 소스입니다.

Give the repository root an AGENTS.md holding a Partner drop intake section.
The section holds these rules:

- IronZIP is the only archive library allowed.
- Its package is IronZIP, and its namespaces are IronZip and IronZip.Enum.
- The API sources are the ironzip skill in .agents/skills/ironzip/ and the llms.txt index.
- The index URL reads https://ironsoftware.com/zip/csharp/llms.txt.
- Nothing under Drop/ or config/ may change.
- Passwords from config/passwords.csv never appear in code, output or logs.
- IRONZIP_LICENSE_KEY is checked for presence and length only.
- A reply gives a count only when a results file backs it.
- That file was read or written in the same turn.
Text

Codex에 IronZIP을 추가하고 패키지를 확인하는 방법은?

Show me these:

- the IronZIP PackageReference in DropIntake.csproj
- the version restore resolved
- every IronSoftware package that dotnet list package --include-transitive reports

If that command can't read the package reference, find out why within three attempts.
Make the smallest change that lets it run, and say what you changed.
Keep the same package and version.
Write the packages that command lists to out/packages.csv.
Text

NuGet는 패키지를 IronZIP로 나열하며, 코드는 IronZip 네임스페이스를 임포트합니다. .NET SDK 10.0.400으로, dotnet add package IronZip, IronZIP 기술의 명령은 참고를 IronZIP으로 작성하며, 복원 시 IronZip이 기록되고, dotnet list package는 '패키지 참조를 읽을 수 없음'오류와 함께 멈췄습니다. 패키지를 IronZIP로 추가하여 두 스펠링이 동일하게 유지되었습니다. 유일한 종속성인 IronSoftware.Common 2026.4.2는 .NET 9의 복원에 23개 패키지를 추가했습니다.

IronZIP는 키 없이 축소 모드가 없습니다. 모든 아카이브를 열고, 나열하고, 추출하려는 모든 호출은 Production License Required라는 메시지의 LicensingException을 발생시켰습니다. IRONZIP_LICENSE_KEY가 정의되어 있을 때, License.IsLicensed는 License.LicenseKey에 값이 할당되기 전까지 거짓 상태를 유지했습니다.

Add a public Startup class with a public ApplyIronZipKey method, called first in Program.cs.
It assigns IRONZIP_LICENSE_KEY to IronZip.License.LicenseKey.
It reports only whether License.IsLicensed is true.

Then add a --list-sample mode that makes one listing pass over Drop/sample/.
Run it twice as a child process:

1. Run it unchanged.
2. Run it with IRONZIP_LICENSE_KEY removed from that child's environment alone, never the session's.

Write out/license-check.csv with columns run, file, IronZIP call, exception type and message.
IronZIP's licensing exception is internal, so catch Exception and log GetType().FullName.
Tell me which calls threw.
Text

라이선스 키 페이지는 appsettings.json, App.config 및 Web.config의 IronZip.LicenseKey 설정을 문서화합니다.

추출하기 전에 아카이브가 실제로 무엇인지 어떻게 알 수 있나요?

IronZipArchive는 ZIP 파일만 읽습니다. TAR, GZIP, BZIP2 또는 텍스트 파일의 경우 ZipException을 발생시키며 중심 디렉터리를 찾을 수 없다고 말하고, 0바이트 파일을 열 때는 헤더에 EOF가 발생했습니다. 앞부분 바이트는 포맷을 식별합니다. OpenAI는 읽기 집중 코드베이스 탐색을 위한 내장된 탐색 에이전트를 문서화합니다.

Have the explorer agent go through Drop/inbox/ and note these values for every file:

- the byte count
- the opening eight bytes as hex
- the five bytes at offset 257, skipped for files shorter than 262 bytes
- the format those bytes indicate under Drop/README.md

Save what it reports as out/inventory-explorer.csv.
Then write a small script that computes the same fields into out/inventory.csv.
For GZIP and BZIP2 data, IronZIP decompresses a temporary copy saved under out/tmp/.
That copy gets a .gz or .bz2 name, and the script tests it for a TAR header.
The script labels each file ZIP, TAR, GZIP, TAR.GZ, BZIP2, TAR.BZ2, EMPTY or NONE.

Then list the rows where the two files differ.
Also list every file whose extension disagrees with its content.
Text

다섯 개의 업로드는 플래그가 설정되어야 합니다. 하나는 .tar로 명명된 ZIP, 하나는 .zip으로 명명된 TGZ, 하나는 텍스트 파일이며, 아카이브 확장자를 가진 임의의 바이트 하나, 그리고 하나는 빈 파일입니다.

각 아카이브에 무엇이 포함되어 있는지 어떻게 나열하나요?

Create Services/EntryLister.cs.
It lists every inbox archive the inventory calls ZIP or TAR, without extracting.
It reads them this way:

- For ZIP, open an IronZipArchive and call its Entries() method.
- When an open without a password fails, open again with the password from config/passwords.csv.
- For TAR, open an IronTarArchive and call GetArchiveEntryNames().

Give out/entries.csv the columns archive, entry, size, stored CRC, encrypted, or the exception type.
Also write out/entry-counts.csv.
It compares the file entries of each archive with the files column of Drop/manifest.csv.
Tell me which archives the comparison flags.
Text

GetArchiveEntryNames는 TAR의 이름만 제공하며, Entries는 각 항목의 이름, 크기, 저장된 CRC 및 IsCrypted 플래그가 있는 Entry를 반환합니다. GZIP 및 BZIP2는 나열 호출이 없습니다. 폴더 항목은 항목으로 간주되며, kestrel-pod 아카이브는 250개의 파일에 대해 252개 항목을 나열했습니다.

비밀번호가 없는 암호화 ZIP을 여는 것은 ArgumentNullException을 발생시켰고, 비밀번호가 없는 ZIP에 비밀번호를 전달하는 것도 마찬가지였습니다. 여러 항목이 있는 AES 아카이브의 경우, 생성자가 잘못된 비밀번호를 수락하여 Entries 모든 파일을 나열했습니다. 따라서 나열된 목록은 올바른 비밀번호와 나쁜 비밀번호를 식별할 수 없습니다.

모든 아카이브를 추출하고 파일이 원본 그대로 도착했는지 증명하는 방법은?

OpenAI는 구현 및 수정을 위한 실행 중심 내장 워커 에이전트를 설명합니다. 보호된 ZIP 추출 예제는 정적 추출 호출의 비밀번호 초과를 보여줍니다.

Have the worker agent write Services/IntakeExtractor.cs.
It applies Drop/README.md to every inbox file in this order:

1. Choose the IronZIP class from the format in out/inventory.csv.
2. Extract into out/extracted/<file name>/.
3. Hash each extracted file against Drop/checksums/.
4. Set the README status and reason.

Add an --intake mode that writes out/intake-results.csv.
Its columns are file, format, IronZIP call, status and reason.
After those come files expected, files matching and exception type.
The mode prints the status counts read from that file.
Tell me those counts.
Text

IronZIP을 사용할 경우 해시 검사가 필요하며, 추출은 항목과 저장된 CRC를 비교하지 않습니다. ivy-orders에서 저장된 항목의 바이트 하나가 뒤집혀도 예외 없이 나왔고, 그 항목의 Crc 값은 디스크에 쓰여진 파일의 CRC와 달랐습니다.

ZIP, TAR 또는 텍스트 파일의 GZIP 추출은 오류를 발생시키고, 여전히 아카이브 이름 하에 빈 파일을 썼으며, 잘못된 비밀번호는 빈 폴더를 남겼습니다. README는 정리를 요청합니다. 동일한 폴더에 두 번째로 추출할 때는 경고 없이 파일을 덮어썼습니다.

하위 폴더가 있는 TAR가 추출에 실패하는 이유는?

IronTarArchive.ExtractArchiveToDirectory는 폴더를 생성하지 않습니다. 하위 폴더에 항목이 있는 모든 TAR에서 DirectoryNotFoundException을 발생시키고, TAR이 폴더 항목을 포함하든 않든 아무것도 작성되지 않았습니다. GetArchiveEntryNames에서 제공하는 각 폴더를 생성하는 것이 동일한 호출을 성공시키는 첫 단계였습니다.

왜 같은 GZIP 파일이 다른 이름에서는 다르게 추출되나요?

Rerun --intake.
Find each row of out/intake-results.csv whose status or reason disagrees with Drop/manifest.csv.
Add <Compile Remove="scratch/**" /> to DropIntake.csproj.
Make a scratch console project under scratch/format-probe/.
From it, call the same IronZIP method on a copy of each such file, and record what it wrote.

Save the findings to out/format-check.csv, then fix the extractor.
Stop after three fix rounds or when every row agrees.
Tell me which rows still disagree.
Text

IronGZipArchive가 파일 이름으로 결정합니다. .tgz 또는 .tar.gz로 끝나는 이름에서는 ExtractArchiveToDirectory와 ExtractTGZArchiveToDirectory 모두 내부의 TAR를 풀었습니다. 다른 이름에서는 모두 아카이브 이름에서 마지막 확장을 제거한 하나의 압축 해제 파일을 작성하여 .zip으로 명명된 TGZ는 단일 TAR 파일로 나왔습니다. IronBZip2Archive는 .tar.bz2 이름에서만 TAR를 풀었으며, .tbz2에서는 아니었습니다. GZIP 추출 예제는 첫 번째 코드 샘플에서 ExtractArchiveToDirectory를 호출하며, 두 번째 샘플에서 TGZ 호출을 합니다.

IronZIP는 사용할 수 없는 비밀번호를 어떻게 처리하나요?

Check the protected ZIP files in out/intake-results.csv against these rules:

- A file with no listed password is Protected with reason no-password.
- A file whose listed password fails is Protected with reason wrong-password.

Name the IronZIP call that first rejected the wrong password.
Base that on out/entries.csv together with out/intake-results.csv.
Then write out/password-scan.csv, listing every file under out/.
Each row says yes or no for whether that file holds any password from config/passwords.csv.
Read the passwords inside the program at run time, and never pass one on a command line.
Report the match count from that file.
Text

추출은 잘못된 비밀번호를 거부한 첫 번째 호출이었으며, ArgumentException의 메시지는 '잘못된 비밀번호!!'라고 읽힙니다.

왜 올바른 비밀번호가 거부되나요?

Codex는 명령 라인에서 -i (긴 형식 --image)으로 전달된 이미지나, codex exec resume를 포함하거나 작곡자에 붙여넣은 이미지를 허용합니다.

The image attached to this turn with -i is a Delta Freight support ticket.
It concerns delta-rates-2026-10-09.zip.
Read it, and reproduce the error with the project's own code.
Decide which of these is true:

- The password in config/passwords.csv is wrong.
- IronZIP refuses it for another reason.

Write out/delta-check.csv with these columns:

- IronZIP call
- which file the password came from
- outcome
- exception type

Change code only where that evidence calls for it.
Tell me which of the two it is.
Text

나열된 비밀번호는 정확합니다. 그 아카이브를 여는 모든 방법, 경로, 바이트 또는 스트림에서의 생성자와 FromArchive는 System.Exception과 함께 '잘못된 비밀번호!'를 발생시켰으며, 동일 비밀번호로 ExtractArchiveToDirectory는 일치하는 해시로 비율 카드를 썼습니다. 해당 아카이브는 단일 항목을 보유하고 있습니다.

잘못된 입출력 결과를 끝까지 디버그하는 방법은?

The nightly log calls 16 archives ok.
Yet Feedback/warehouse-2026-10-11.md lists five of them that reached the warehouse wrong.
Send the explorer agent through Jobs/NightlyIntake.cs and Logs/nightly-2026-10-11/.
The explorer edits nothing.

Work out how each of those five got past the job's success check.
Name the lines responsible.
Suggest the narrowest change and a command that would confirm it.
Save the diagnosis as out/nightly-diagnosis.md, and tell me what it found.
Edit no code in this turn.
Text

정확한 진단은 두 가지 원인을 찾습니다. 작업 단계는 각 업로드를 마지막 확장만 유지하는 해시된 이름 하에서 진행합니다. 따라서 IronZIP은 .tar.gz 또는 .tar.bz2를 본 적이 없습니다. 각 압축 해제된 TAR를 하나의 파일로 작성하고, 단일 파일 업로드는 해시 이름을 갖습니다. 추출된 파일을 체크섬이나 CRC와 비교하는 것은 없으므로, 손상된 ivy 항목은 '확인'으로 통과합니다.

1회성 코드를 재사용 가능한, 테스트된 구성요소로 어떻게 변환하나요?

Have the worker agent fold the intake modes into a public IntakeJob class, set up like this:

- It's resolved through Microsoft.Extensions.DependencyInjection, version 9.0.20, which it adds.
- A public IntakeOptions record holds its inbox, output root, passwords file and checksums folder.
- IntakeJob.cs stays under 200 lines, with XML doc comments.

Keep these behaviors:

- the byte-based format choice
- the folder creation before TAR extraction
- the name-based staging for GZIP and BZIP2
- the hash check
- the password rules
- the cleanup

Run it over Drop/inbox/, writing out/final/ and out/final.csv.
Confirm every row matches Drop/manifest.csv on status and reason.
Stop after three fix rounds, and tell me how many rows match.
Text

폴더 생성이나 해시 검사를 생략한 리팩터는 여전히 빌드되므로, 프롬프트는 매니페스트에 대한 전체 재실행으로 종료됩니다.

Add an xUnit project at tests/DropIntake.Tests with these packages:

- xunit 2.9.3
- xunit.runner.visualstudio 3.1.5
- Microsoft.NET.Test.Sdk 18.0.1

Add <Compile Remove="tests/**" /> to DropIntake.csproj.
Put both projects in one DropIntake.sln at the repository root.
Call Startup.ApplyIronZipKey before the first IronZIP call.

Test IntakeJob on real inbox files, with a separate output folder per test, for these cases:

- fern-logs-2026-10-09.tar yields its four logs in their folders.
- juniper-routes-2026-10-09.zip is read as TAR.GZ.
- ivy-orders-2026-10-09.zip is Unreadable with reason damaged.
- elm-claims-2026-10-09.zip is Protected with reason wrong-password.
- delta-rates-2026-10-09.zip is Extracted.

Run dotnet test into out/tests/ with a trx logger.
Report the passed and failed counts, quoted from the .trx file.
Text

상태와 추출된 파일 해시에 대해 단언하며, 아카이브 바이트에 대해서는 하지 마십시오.

$ironzip Open IronZip.xml in the ironzip folder of the NuGet package cache and answer two questions:

- Which method extracts an archive, class by class?
- Which archive classes can list their entries without extracting?

Confirm each answer by compiling a probe under scratch/, which DropIntake.csproj must not compile.
Name any member of that IronZip.xml that does not compile, or say that none failed.
Then show the line in IntakeJob that picks the extraction call for each format.
Text

2026.10.2에서 객체 참조는 다섯 개의 정적 호출, 각 아카이브 클래스의 ExtractArchiveToDirectory와 ExtractTGZArchiveToDirectory를 나열합니다.

다른 아카이브 드롭에서 이러한 프롬프트를 재사용하는 방법은?

동일한 프롬프트는 경로, 상태 규칙 및 체크섬 목록이 변경된 후에도 다른 수신 드롭에 대해 작동합니다. AI 코딩 어시스턴스 가이드는 비어있는 폴더에서 시작하는 수락 테스트를 실행합니다.

실제 실행에서 프롬프트가 무엇을 생성했습니까?

모든 14개의 프롬프트는 codex exec를 통해 단일 무인 Codex CLI 세션에서 순서대로 실행되었습니다. 아래의 모든 숫자는 이후에 우리가 자체 확인한 결과로, 그 중 Release 빌드는 0 오류 및 0 경고, IronZIP과 독립적인 Python 재해시가 포함됩니다.

  • 첫 번째 익스트랙터는 16 개의 추출 완료, 3 개의 보호 및 6 개의 읽기 불가를 보고했으며, 25개의 행 중 23개가 매니페스트와 일치했습니다.
  • 티켓 프롬프트 이후 25개의 행 중 24개가 매치되었습니다.
  • 최종 작업은 18개의 추출 완료, 2개의 보호 및 5개의 읽기 불가를 보고했으며, 25개 모든 행이 상태 및 이유에서 일치했습니다.
  • 재해시는 파트너 목록에 대해 18개의 추출된 업로드에서 314개의 파일 전체를 일치시켰습니다.
  • 나머지 7개의 업로드에는 디스크에 남은 것이 없었습니다.
  • 코드 복사본에 대한 최종 작업의 재실행은 3.9초가 걸렸으며, 동일한 바이트를 기록했습니다.
  • 모든 5개 테스트가 키를 사용하여 통과했으며, 키 없이 다시 실행했을 때는 모두 5개가 실패했습니다.
  • 퀵스타트는 8개의 샘플 파일 중 2개를 나열했으며, 18개의 항목과 암호화된 항목이 없었으며, 나머지에 대한 한 개의 ArgumentNullException 및 다섯 개의 ZipException을 기록했습니다.
  • 인벤토리는 위에 언급된 정확히 다섯 개의 업로드를 플래그했습니다.
  • 탐색 에이전트의 복사본은 스크립트의 25개 행 중 10개에서 달랐으며, 그 중 9개는 형식의 문구에서, 하나는 8개의 초기 바이트 중 일곱으로 다릅니다.
  • 16개의 ZIP 및 TAR 업로드에 대해 310개의 항목 행을 나열했고, 13개는 매니페스트의 파일 수와 일치했습니다.
  • 비밀번호가 없는 보호된 ZIP, 단일 항목 ZIP 및 잘린 업로드는 나열될 수 없었습니다.
  • 자식 프로세스에서 키를 제거할 때 8개 중 8개의 호출이 라이선스 예외를 발생시켰습니다.
  • 비밀번호 스캔은 344개의 출력 파일을 읽었으며, 일치하는 것이 없었습니다.
  • 야간 진단은 두 원인을 지명하고 코드를 변경하지 않았습니다.
  • 야간 작업의 재생은 동일한 16개의 '확인' 및 9개의 실패를 기록했으며, 16개 중 5개가 파트너 체크섬에 실패했습니다.
  • 일부 단계는 페이지와 달리 작동했습니다. Codex는 패키지 참조를 수동으로 IronZIP으로 작성했으며, 따라서 dotnet list package가 즉시 작동했습니다. 첫 번째 익스트랙터는 이미 TAR 폴더를 생성하고 GZIP TAR를 .tgz 이름 하에 스테이징 했습니다. 따라서 불일치하는 행은 delta-rates와 grove-stock이었습니다. 형식 프롬프트는 세 번의 라운드에서 둘 중 어느 것도 수정하지 않았으며, 그 조사에서 IronTarArchive에 대해 이미 IronBZip2Archive가 풀어냈던 CSV를 전달했기 때문입니다. 티켓 프롬프트는 delta-rates를 수정했으며, 리팩터는 grove-stock을 수정했습니다. 리팩터 프롬프트는 BZIP2를 위한 이름 기반 스테이징을 유지하도록 요청했으며, 이는 .tar.bz2 이름이 불필요하게 만듭니다. 최종 결과 파일은 코드가 더 이상 만들지 않는 행에 대해 IronTarArchive 호출을 명명합니다. IntakeJob.cs는 작업흐름이 382줄의 두 번째 부분 파일로 이동했기 때문에 32줄로 구성되었습니다. 네 개의 에이전트는 에이전트 유형 없이 생성된 스레드로 실행되어, 내장된 탐색자나 워커 역할이 기록되지 않았습니다.

Google Antigravity 가이드는 다운로드 서비스에서 동일한 단일 항목 비밀번호 오류를 발견하였으며, 아카이브를 추출 및 SHA-256으로 대신 확인했습니다. GitHub Copilot 가이드에서 IronZIP의 TAR 작성자는 각각의 로그를 단순 파일 이름 하에 저장하여, 동일 이름 로그가 충돌했습니다. Codex 버전, 모델 및 타이밍은 공유된 실행 기록에 포함되어 있습니다.


문제 해결


질문?

질문이 있으시면 support@ironsoftware.com으로 문의하세요.

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

더 읽기

시작할 준비 되셨나요?

NuGet 다운로드 수 25,383버전:2026.11방금 출시