Claude Code로 IronXL 사용하는 방법

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

백만 개의 저널 라인이 있는 총계정 원장이 Excel에서 불편 없이 열리고, 그것을 읽어야 하는 가져오기 작업이 중단됩니다. 우리 테스트 머신에서 WorkBook.Load는 해당 크기의 60MB 워크북을 읽기 위해 약 26초와 3GB의 메모리가 필요했으며, 테스트 시나리오의 컨테이너는 .NET 힙을 512MB로 제한합니다. Anthropic은 터미널을 위한 Claude Code, VS Code 및 JetBrains IDE, 데스크톱 및 웹용으로 제공합니다. 이러한 장소 각각에서 에이전트가 리포지토리를 읽고, 파일을 변경하고, 명령을 실행할 수 있습니다.

IronXL은 XLSX 파일에 접근하는 두 번째 방법을 가지고 있습니다. 해당 리더는 한 번도 계산되지 않은 수식에서 .xls 파일까지 여러 입력을 처리할 수 없으며, 이것에 대해 알지 못하는 에이전트는 WorkBook.Load나 조용히 전체 파일을 버퍼링하는 오버로드를 사용할 수 있습니다. 이 가이드는 Claude Code에 대해 검증된 네 가지 프롬프트를 제공합니다. Sonnet은 짧은 작업을 처리하고, Opus는 계획 모드에서 벤치마크를 설계하며, 읽기 전용 프로젝트 하위 에이전트가 결과를 검토합니다.

네 가지 프롬프트 중 세 가지는 /model 라인으로 시작하며, 선택한 모델은 다른 것을 선택할 때까지 활성 상태로 남아 있습니다. Anthropic의 모델 구성 페이지는 sonnet 별칭을 일상적인 코딩 작업에 대한 선택으로, opus는 복잡한 추론에 대한 선택으로 설명합니다.

빠른 시작
NuGetNuGet으로 설치

PM > Install-Package IronXL.Excel

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

리포지토리에서 터미널을 열고 claude를 시작하세요. 독자적 메시지로 /model 라인을 보내고, 블록의 나머지를 요청으로 보냅니다. @를 경로 앞에 입력하면 해당 파일이 첨부되어 열이 표시되기 전에 코드가 에이전트에 도달합니다. 워크북이 아니라 노트를 언급하세요, 왜냐하면 60MB의 압축 XML은 코드가 읽어야 하기 때문입니다.

/model sonnet

Add the IronXL.Excel NuGet package to LedgerScan.
Then read data/gl-2025.xlsx with it, without building a WorkBook.
The column notes are in @docs/ledger-export.md.
The license key is in the IRONXL_LICENSE_KEY environment variable. Don't print it.

Print every worksheet name first.
After that, make one forward-only pass over the Ledger sheet and print four figures:

- how many data rows the sheet holds
- the Amount total of the Posted rows
- how many seconds the pass took
- the peak working set of this process in megabytes
Text

우리의 실행에서 Claude Code는 또한 옵션으로 첫 번째 행을 헤더로 표시하여 각 셀을 열 이름으로 읽을 수 있도록 전달했습니다. 기가바이트에서의 피크는 코드가 워크북을 로드했다는 의미이고, 600MB 이상에서의 피크는 IronXL에 스트림이나 바이트 배열을 넘겼다는 의미입니다.

StreamCell.Value는 모든 숫자를 박스형 더블로 보유하므로, 해당 값을 decimal로 캐스트할 경우 InvalidCastException이 발생하고, 불변 문화의 Convert.ToDecimal가 수정입니다. 우리의 모든 실행에서는 처음부터 Convert를 사용했습니다.



Claude Code는 .NET Excel 프로젝트에서 무엇을 하나요?

Excel 프로젝트에서 Claude Code는 원장 리더를 작성하고 각 리더를 별도의 프로세스로 시작합니다. 워크북을 설명하고 반환된 수치를 검토하세요.

Claude Code를 어떻게 설정하나요?

Anthropic의 quickstart로 Claude Code를 설치하고 로그인하세요. 시작하고 응답할 때 환경이 준비됩니다.

Claude Code가 작업할 수 있는 프로젝트를 어떻게 설정하나요?

테스트된 리포지토리는 .NET 9 콘솔 앱으로, 두 개의 입력인 원장 워크북과 열을 설명하고 프로덕션 컨테이너의 512MB 힙 제한을 기록하는 Markdown 파일이 있습니다.

Claude Code는 CLAUDE.md를 각 세션이 열릴 때 읽습니다. 규칙은 스트리밍 가이드를 URL로 지정합니다. IronXL의 llms.txt 인덱스는 가이드를 나열하지만, 그 skill.md는 2026.8.1 IronXL에 고정되어 있으며, StreamRows이 2026.9.2에 출시되기 전의 릴리스입니다. 해당 파일이나 llms-full.txt에서는 StreamRows이 언급되지 않으므로, 해당 파일만 읽는 에이전트는 WorkBook.Load만 학습합니다. 프로젝트 하위 에이전트는 .claude/agents/ 아래에 있는 Markdown 파일이며, frontmatter는 그것을 명명하고, 사용할 시기를 말하며, 호출할 수 있는 도구를 나열하고, 모델을 선택합니다. IronXL이 Quickstart에 의해 이미 참조되고 있으므로, 이제 하나의 프롬프트로 두 파일을 작성합니다.

This repo needs a CLAUDE.md at its root, with a section named Large workbooks.
Write it so every later session starts from these rules:

- IronXL.Excel stays on the version LedgerScan.csproj references now.
- Read workbooks under data/ with WorkBook.StreamRows and a file path, never a Stream or byte[].
- Use WorkBook.Load in a test or benchmark that compares it with StreamRows.
- Outside those, use WorkBook.Load only when the file is .xls, has a password or must be edited.
- Any StreamCell can be null on a sparse row.
- Convert StreamCell.Value with Convert. Don't cast it.
- Memory and time figures come from a separate child process, one per reader.
- A long command runs in the foreground until it exits, never as a background task.
- The license key comes from IRONXL_LICENSE_KEY and nowhere else. Don't print it.
- The reference is https://ironsoftware.com/excel/csharp/how-to/stream-large-excel-files/.

Then create .claude/agents/stream-auditor.md, a project subagent that runs on sonnet.
Give it Read, Grep and Glob and no other tools, and a description that says when to use it.
It checks C# changes against that section and against IronXL.xml in the local NuGet cache.
It replies with the file, the line and the rule broken, and it edits nothing.
Text

Claude Code는 새 파일을 위해 .claude/agents/를 감시하지만, 해당 폴더가 세션 시작 시 존재했을 때만 그렇습니다. 이 프롬프트가 폴더를 생성하는 리포지토리에서, 다음 프롬프트 전에 claude --continue로 다시 시작하여 하위 에이전트가 사용 가능하도록 만드세요.

첫 번째 읽기 전에 라이선스를 정리하세요. 키가 없으면 스트리밍 및 시트 이름 호출은 파일이 열리기 전에 호출되는 순간 LicensingException을 던집니다. 시작 시 License.IsLicensed을 확인하세요. IronXL License Keys 페이지는 키 얻기 및 저장을 다룹니다.

어떤 IronXL 설정이 CLAUDE.md에 포함되어야 하나요?

손으로 작성된 CLAUDE.md의 경우, 아래 블록이 동일한 섹션을 포함합니다.

## Large workbooks

- Keep IronXL.Excel on the version LedgerScan.csproj references now.
- Read workbooks under data/ with WorkBook.StreamRows and a file path, never a Stream or byte[].
- WorkBook.Load is fine in a test or benchmark that compares it with StreamRows.
- Anywhere else, use WorkBook.Load only when the file is .xls, has a password or must be edited.
- Any StreamCell can be null on a sparse row.
- Convert StreamCell.Value with Convert. Don't cast it.
- Take memory and time figures from a separate child process, one per reader.
- Run a long command in the foreground until it exits, never as a background task.
- Read the license key from IRONXL_LICENSE_KEY and nowhere else, and never print it.
- The reference is https://ironsoftware.com/excel/csharp/how-to/stream-large-excel-files/
Markdown

왜 큰 Excel 파일은 C#에서 스트리밍이 필요하나요?

WorkBook.Load는 모든 셀, 스타일 및 수식을 메모리에 완전하게 로드하고 무작위 접근 및 편집이 가능하며, 메모리에 완전한 워크북을 빌드합니다. 해당 모델은 파일보다 비용이 훨씬 많이 듭니다. WorkBook.StreamRows는 XML 워크시트를 순서대로 읽고 매번 한 줄을 유지하며, 이는 가져오기, 합계 및 검증에 충분합니다. 아래 수치는 1,000,000행, 10열, 각 행에 고유한 설명이 있는 60MB XLSX 파일인 기준 워크북에서의 캘리브레이션에서 나옵니다. 각 리더는 자신만의 프로세스에서 세 번 실행되었으며, 표에는 중간값이 표시됩니다.

리더시간첫 번째 행피크 작업 세트512MB 힙 제한
파일 경로로 StreamRows10.6 초1.0 초178 MB178 MB에서 완료
스트림으로 StreamRows10.6 초1.6 초641 MB1.5 초에 메모리 부족
바이트 배열로 StreamRows10.4 초1.5 초628 MB1.6 초에 메모리 부족
파일 경로로 WorkBook.Load26.4 초23.7 초3,072 MB1.2 초 내 실패

네 리더 모두 지역과 월별로 동일한 60 포스팅 총계를 생성했습니다.

경로 리더의 수치는 파일 내 텍스트에 따라 다릅니다. XLSX 파일은 각 고유 문자열을 한 번씩 유지하고, 공유 문자열 테이블에서 보유하며, 많은 항목이 있는 표는 스트림을 무겁고 시작이 느리게 만듭니다. 500,000행에서, 258개의 문자열을 반복한 워크북은 첫 번째 행 후 0.22초에 81MB 피크로 스트리밍되었고, 모든 설명이 고유한 워크북은 130MB와 0.58초를 필요로 했습니다. 밀리언 행 피처는 1밀리언 이상의 고유 문자열을 가지고 있습니다.

어떤 StreamRows 오버로드를 사용해야 하나요?

파일 경로를 받는 오버로드만 사용하세요. StreamRows에는 9개의 오버로드가 있습니다. 이는 경로, 스트림 또는 바이트 배열 입력 각각을 시트 인덱스, 시트 이름 또는 StreamReadOptions과 결합한 것입니다. 경로 오버로드는 패키지를 디스크에서 부품별로 읽습니다. 스트림 오버로드와 함께 제공되는 문서는, 이를 구문 분석 전에 비공개 버퍼에 스트림을 복사하여 IronXL이 호출자가 소유하는 스트림을 닫지 않도록 하고, 해당 복사를 "메모리 절약 경로가 아니다"라고 설명합니다. 스트리밍 가이드는 오버로드 테이블에서 동일한 선을 그립니다.

바이트 배열 오버로드의 XML 문서는 여전히 이를 "메모리 절약 읽기"로 설명하지만, 60MB 피처 기준에서 스트림과 바이트 배열 오버로드 모두 디스크에 있는 파일 크기의 열 배 이상으로 피크에 도달했습니다. 스트림으로 파일을 받는 업로드 핸들러는 이를 임시 파일로 저장하고 경로를 스트림으로 연결해야 합니다.

스트리밍 벤치마크를 어떻게 요청하나요?

하나의 프롬프트에서 전체 비교를 요청하고 Opus가 이를 계획하도록 하세요. /model opus 라인 후, Shift+Tab으로 권한 모드를 전환하여 상태 표시줄에 계획 모드가 켜져 있는지 확인한 후 요청을 전송하세요. 계획 모드는 Claude Code가 파일을 읽고 쉘 명령을 실행할 수 있도록 하며, 계획이 승인되기 전까지 소스 파일을 편집하지 않습니다.

/model opus

Plan a reader benchmark for data/gl-2025.xlsx under Ledger/, then build it.

I want three readers behind one interface.
Each one returns Posted Amount totals keyed by Region and the calendar month of PostedOn.

- PathStreamReader passes the file path to WorkBook.StreamRows.
- UploadStreamReader opens a FileStream and passes that stream, as an upload handler would.
- FullLoadReader calls WorkBook.Load and indexes cells with GetCellAt.

FullLoadReader reads WorkSheet.RowCount and ColumnCount once each, before its loops.
It never touches PhysicalColumnCount.

Add a bench command to Program.cs that does this:

1. Start this program again as a child process for each reader, with no memory limit.
2. Do the same with DOTNET_GCHeapHardLimit=0x20000000 in the child's environment.
3. Record exit code, wall-clock seconds, seconds until the first data row, and peak working set.
4. Write out/bench.csv with one line per reader and limit.
5. Write out/totals.csv from the path reader.
6. Fail the command if a reader that exited cleanly differs from the path reader on any total.

Run the bench, then ask @agent-stream-auditor to review Ledger/ and Program.cs.
Show me out/bench.csv and what the auditor found.
Text

프롬프트의 각 부분은 수치가 실제보다 좋게 보이게 할 틈을 막습니다.

  1. 하나의 파일에 세 리더: 업로드 스타일 FileStream 리더가 세트에 포함되어, 벤치마크가 오버로드 선택뿐만 아니라 로딩에 대한 스트리밍을 테스트합니다.
  2. 자식의 환경에서 힙 제한: DOTNET_GCHeapHardLimit는 16진수 바이트 수로 가비지 컬렉터가 커밋할 수 있는 최대 메모리를 설정하며, 0x20000000은 512MB입니다. 이를 초과하는 리더는 자신의 프로세스에서 실패하고, 벤치가 종료 코드를 기록하여 충돌 대신 종료됩니다.
  3. 총계가 일치해야 함: 빠르고 틀린 리더는 명령을 실패시킵니다.
  4. 하위 에이전트가 턴을 종료함: @agent-stream-auditor는 프로젝트 하위 에이전트를 직접 명명하여 Claude Code가 해당 하위 에이전트에 검토를 위임합니다.
팁: 자식 프로세스가 환경을 가져오는 위치와 총계가 비교되는 위치가 표시되면 계획을 수락하세요. 부모 프로세스에 힙 한도를 설정하는 계획은 벤치 자체를 포함하여 모든 리더의 한도를 설정합니다.

프롬프트는 로딩 리더가 시트를 어떻게 탐색하는지 명시적으로 설명합니다. 전체 로딩 기준에는 자체 함정이 있습니다. WorkSheet.RowCount는 33.5 밀리초를 소요하는 모든 읽기에서 비용이 듭니다, 그리고 로드된 백 만행 시트에서 한 번 호출은 33.5 밀리초가 걸렸습니다. 모든 패스에서 RowCount를 읽는 루프는 각 시간에 그 비용을 지불하며, 이는 이 시트에 대해 약 9시간이 됩니다. 루프 전에 한번 수를 읽는 것이 로드된 셀 위의 전체 패스를 1.8초로 줄였습니다. WorkSheet.PhysicalColumnCount는 훨씬 더 많은 비용이 듭니다. 로드된 원장에서 한 번의 호출은 45에서 50초를 소요하고 프로세스를 3GB에서 6.7GB로 올렸으며 ColumnCount는 약 0.1초 내에 동일한 10개열을 반환했습니다. WorkSheet.Rows를 열거하는 것은 비용을 피하지 않았습니다. 이는 로드된 50,000행에 대해 8초, 100,000행에 대해 61초가 걸렸으며, 백만 행 시트에서 이는 15분 후에도 행 100,000에 도달하지 못했습니다.

리더별 메모리 사용량을 어떻게 측정하나요?

각 리더를 별도의 프로세스에서 실행하세요, 왜냐하면 피크 작업 세트가 전체 프로세스의 최고 수위이고 결코 떨어지지 않기 때문입니다. 한 번의 조사에서, 단일 프로세스가 워크북을 로드하고 경로 리더를 실행하였고, Process.PeakWorkingSet64가 스트림을 위해 3,047MB를 보고했으며, 이는 로드의 수치입니다. 별도의 프로세스는 두 수치를 분리시켰습니다.

Microsoft의 가비지 수집기 설정 페이지에서는 .NET이 기본적으로 컨테이너의 메모리 제한의 75%를 적용한다고 언급하므로, 512MB 제한은 약 683MB로 제한된 컨테이너에 맞습니다. 그 제한 아래에서, 스트림 및 바이트 배열 리더는 모든 세 번의 캘리브레이션 반복에서 "메모리 부족."으로 멈췄습니다. 전체 로드는 두 번 실패했으며 동일한 메시지와 함께 한 번 FileLoadException 및 "주어진 스트림에서 Excel을 로드할 수 없음." 구문 분석 중 스트림이 읽을 수 없게 되었으며, 이는 파일 크기에 비해 메모리가 부족할 수 있음을 나타낼 수 있습니다."

StreamRows의 한계는 무엇인가요?

StreamRows은 XLSX 워크시트에서 값을 순서대로 읽으며 그 외 다른 일을 하지 않습니다. 스트리밍 가이드는 경계를 나열하고, 아래 표는 IronXL 2026.10.1이 우리 조사에서 각각을 어떻게 처리했는지를 기록합니다.

입력StreamRowsWorkBook.Load
.xls 파일OLE2NotOfficeXmlFileException로드됩니다
비밀번호가 있는 .xlsxOLE2NotOfficeXmlFileExceptionWorkBook.Load 및 비밀번호로 로드됨, 아니면 ArgumentNullException
CSV 파일ZipException "중앙 디렉토리를 찾을 수 없음"로드됩니다
캐시 결과가 있는 수식캐시된 결과, IsFormula true수식과 값
결과 없이 수식 저장됨Type Blank, Value null, IsFormula true값을 계산함
경로 누락첫 줄에 ZipException "헤더에 EOF"FileNotFoundException
시트 이름 누락첫 줄에 ArgumentException "Sheet 'Ledger' was not found."적용 안 됨

처음 세 줄의 예외는 IronXL에 포함된 라이브러리에서 나오며 생성된 식별자를 포함하는 네임스페이스 이름 아래에 있으므로, 어떤 catch 절도 이를 명명할 수 없습니다. Catch Exception를 첫 열거 주위에 쓰거나, 스트리밍 전에 파일을 확인하세요. .xls 파일과 암호화된 .xlsx 파일 모두 OLE2 서명에서 시작하며, 바이트 D0 CF 11 E0입니다. 첫 호출 전에 File.Exists을 확인하세요. 우리 조사를 보면 존재하지 않는 경로를 스트리밍하면 그곳에 0바이트 파일을 생성했고 나중에 해당 경로의 WorkBook.Load은 오류 대신 하나의 빈 시트가 있는 워크북을 반환했습니다.

생성된 파일에는 수식 행이 가장 중요합니다. Excel은 각 수식 옆에 마지막 계산된 결과를 저장하고 스트림은 해당 결과를 반환합니다. 스크립트에 의해 작성되거나, 저장 전 EvaluateAll를 호출하지 않은 IronXL 자체에 의해 작성된 워크북은 혼자 수식만 저장하며 스트림은 빈 셀로 이를 봅니다. WorkBook.Load는 셀이 읽힐 때 해당 수식을 계산하므로 로드된 워크북에서 일치하는 총계와 스트림에서 0으로 돌아오는 총계는 이 경우를 가리킵니다. 수식 가이드는 EvaluateAll을 다룹니다.

세 가지 작은 세부사항이 스트리밍된 값에 영향을 줍니다.

  • 행이 드문드문 있음: 빈 셀은 행의 셀에 존재하지 않으며, 인덱서는 null을 반환합니다. TryGetCell은 셀이 null일 때에도 알려진 열에 대해 true를 반환합니다.
  • 행 번호는 시트 위치를 유지함: RowNumber은 0부터 시작하여 시트의 행 2가 1로 도착하며, 빈 시트 행은 후속 행을 재번호화하지 않고 건너뜁니다.
  • 날짜는 형식으로 제공됨: 날짜 셀은 해당 값을 DateTime으로 보고하며, 텍스트는 형식화된 문자열을 보유하며 이는 피처의 날짜 형식에 대해 4-27-25였습니다.

로드될 수 있는 작은 워크북의 경우, XLSX 파일 읽기 및 범위 선택은 셀별 접근을 다룹니다.

스트리밍 시 Excel 오류 값을 어떻게 처리하나요?

Excel에서 저장된 원장은 실패한 조회가 남긴 #N/A와 같은 오류 값을 가질 수 있습니다. 스트림은 오류 유형과 오류 텍스트인 "#N/A" 또는 "#DIV/0!"를 해당 값의 문자열로 보고하고 오류가 수식의 캐시된 결과일 때 그 수식 플래그는 true입니다. Convert.ToDecimal는 해당 문자열을 구문 분석할 수 없으며 FormatException을 던집니다. 우리의 조사에서, 마지막 행의 Amount 셀에 #N/A가 있는 원장의 복사본, 시트 행 1,000,001은 17.3초의 읽기 후에 던지며 총계를 출력하지 않았습니다.

WorkBook.Load은 던지지 않고 오류 셀을 읽습니다. 저장된 오류는 Byte 값으로 오류 코드를 갖고 42는 #N/A, 7은 #DIV/0!이며, 셀 텍스트에는 동일한 숫자가 표시됩니다. DecimalValue는 모든 오류 셀에 대해 0을 반환하며, IsError는 true입니다. 3개의 오류 금액이 '포스트'된 행의 2,000행 원장에 대해, DecimalValue을 더한 로딩 리더는 경고 없이 26,556.59가 부족했습니다. 원시 값을 변환한 경우 두 저장된 오류는 42와 7로 계산했으며 그 수식 오류에서 FormatException를 던졌습니다.

변환 전에 유형을 테스트하세요. Amount만 StreamCellType.Number 일 때 변환하고 샘플의 StreamCellType.Error 케이스를 다루는 것처럼 스트리밍 가이드의 샘플과 함께 다른 셀을 기록하세요. 그 검사가 되어 있는 상태에서 백만 행 패스는 17.6초 만에 끝나고 I1000001 셀을 플래그합니다. 해당 행이 오류가 들어가기 전 보유했던 금액인 5,081.52만큼 정리 파일보다 적은 8,304,532,586.40의 포스트 총계입니다. 로딩 리더는 IsError를 먼저 테스트합니다. 플래그된 셀을 총계 옆에 인쇄하여 짧은 총계가 행에 추적될 수 있도록 하세요.

WorkBook.Load로 돌아가는 방법은 무엇인가요?

Claude Code에 두 번째 파일을 제공하고 두 리더를 비교하게 하세요. 마지막 프롬프트 전에, 우리의 테스트 실행은 스크립트가 생성한 40,000행 워크북을 추가했습니다. 그 유일한 시트는 Adjustments라는 이름이며, 제목과 빈 행이 헤더 위에 위치하고 모든 Amount 셀은 저장된 결과가 없는 수식을 갖고 있습니다.

/model sonnet

Finance added data/gl-2025-q4-adjustments.xlsx.
A Python script of theirs writes it instead of Excel.
It has one sheet, with a title block above the header row.

1. Run PathStreamReader over it and compare its Posted totals with FullLoadReader's.
2. Where they disagree, count the stream's Amount cells per Type, IsFormula and Value combination.
3. If some cells give the stream no figure, fall back to WorkBook.Load for that workbook alone.
4. Print which reader produced each total. data/gl-2025.xlsx keeps streaming.
5. Add the adjustments file to the bench as a second workbook.
6. For that workbook, compare every reader with the fallback totals.
7. Don't fail the bench when a stream reader's totals differ there.
8. Run the bench again, wait for it to exit, then read out/bench.csv.
9. Ask the stream-auditor subagent to review the files this turn changed and nothing else.

Tell me the adjustments total and which reader it came from.
Text

우리의 캘리브레이션에서, 이 파일은 세 가지 방법으로 원장에 대해 작성된 리더를 깨트렸습니다. 원장 시트를 요청하면 ArgumentException를 던집니다. 기본 HeaderRowIndex이 0일 때, 타이틀이 유일한 헤더 이름이 되며 Amount 열 인덱서는 "알 수 없는 헤더 열: 'Amount'."를 던집니다. 헤더 인덱스가 2로 설정되면, 40,000개의 모든 Amount 셀이 빈 수식으로 돌아오며 스트리밍된 포스트 총계는 0입니다.

생성된 IronXL 코드를 신뢰하기 전에 무엇을 검증해야 하나요?

각 변경 후 순서대로 이 두 가지 검사를 완료하세요.

  • 빌드 패스: API 레퍼런스에서 각 멤버를 찾아보고 새 릴리스 빌드에서 다시 실행하세요.
  • 피크는 경로 리더의 것: Quickstart 프롬프트 아래의 임계값에 대해 각 피크를 읽으세요.

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

이 가이드의 네 프롬프트는 하나의 세션에서 Claude Code로 가고 위에 설명된 리포지토리에 대했는데, 작성된 응답은 프롬프트 03에 대한 계획을 승인을 얻었습니다. Quickstart 프롬프트는 버전을 명시하지 않으므로 실행은 2026.10.5 IronXL.Excel을 설치했습니다. 칼리브레이션 표는 2026.10.1을 사용했으며 실행 시간은 더 깁니다.

  • 프롬프트 03 후에 원장은 177.3 MB에서 피크에 도달하고 프롬프트 04 후에는 253.4 MB에 도달했습니다. 네 번째 프롬프트의 코드는 읽기 전에 그 자체의 StreamRows 패스로 헤더 행을 찾습니다.
  • 조정 워크북에서는 스트림이 사용 불가능한 Amount 셀을 가진 36,045개의 포스팅 행을 플래그합니다. 각 워크북에 대한 전체 로딩 대체는 15개의 총계를 생성하여 330,856,030.50으로 합산했으며 284.3 MB 피크로 진행되었으며 512 MB 제한 아래에서 마무리되었습니다.
  • 제한 아래에서, 경로 리더만이 원장을 253.1 MB에서 마무리할 수 있었습니다. FileStream 리더는 556.1 MB에서 메모리 부족으로 종료되고 로딩 리더는 531.0 MB에서 실패했습니다.
  • 제한 없이 최종 벤치는 FileStream 리더가 689.1 MB에서, 로딩 리더가 3,071.3 MB에서 피크를 찍으며, 첫 번째 행은 43.24초 이후에 반환되며 경로 리더는 1.35초입니다. 모든 60개의 총계가 일치했습니다.
  • Quickstart 패스는 1,000,000개의 행을 8,304,537,667.92 포스트 총계로 19.32초에 계산하며 180.96 MB 피크에 도달했습니다.
  • 최종 벤치는 제한이 있는 두 개의 워크북에서 3개의 리더로 12개의 자식 프로세스를 실행하고 코드 0으로 종료되었습니다. 커밋된 코드의 새로운 릴리스 빌드는 이를 재실행했으며, 그 60개의 원장과 15개의 조정 총계는 워크북 생성기가 기록한 값과 일치했습니다.
  • 일부 단계는 페이지와 달리 작동했습니다. 프롬프트 03 계획은 두 가지 질문으로 마무리되었습니다, 그리고 승인 후 Claude Code는 자체 추천을 따랐으며 각 자식에 대해 300초 타임아웃을 가지고 있으며 CLAUDE.md에는 변경이 없었습니다. 그런 다음 하위 에이전트가 프롬프트 03에서 UploadStreamReader와 프롬프트 04에서 WorkBook.Load의 대체가 CLAUDE.md 규칙을 깨트린다고 보고했지만 프롬프트는 그것이 모두를 요청했습니다. Claude Code는 각 발견을 지나치고 규칙을 그대로 내버려 두었으므로, 검토가 깨끗이 되돌아오기를 원할 경우 각 예외를 추가하세요. 모든 벤치는 전경에서 실행되었고 두 검토가 돌아왔습니다.
  • 이전 실행에서는 동일한 프롬프트의 더 긴 문구를 사용했습니다. 그곳에서 하위 에이전트는 WorkSheet.RowCount와 ColumnCount가 누락되었다고 보고했지만 IronXL.xml는 둘 다 Range 아래에 문서화되어 있으며 WorkSheet 클래스가 그것들을 상속받습니다. 해당 실행의 자동 모드는 또한 프롬프트 04에서 하위 에이전트 파일에 대한 편집을 자체 수정으로 거부했으며, 그러한 편집을 스스로 승인할 계획을 가지세요. 그 전에, Claude Code는 두 번 벤치를 백그라운드 작업으로 시작하고 자식들이 여전히 실행 중일 때 턴을 마쳤습니다. 그 실행 중 두 번째에서 PhysicalColumnCount을 매번 테스트하는 헤더 루프도 로딩 자식이 5분 타임아웃을 넘기도록 했습니다.

실행 기록은 이 가이드와 셋의 다른 가이드를 뒷받침하는 버전, 모델, 타이밍 및 테스트 머신을 나열합니다.


문제 해결


질문?

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

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

더 읽기

시작할 준비 되셨나요?

NuGet 다운로드 수 2,393,101버전:2026.11방금 출시