- 실측 상태: 2026-09-12 시험(Claude Code 2.1.221 + Karuzip 2.2.3 개발 빌드)은 OAuth 세션 만료로 중단되어 Karuzip Action 호출 성공 실측이 완료되지 않았습니다.
- Claude Code 실행 도구 자체, 연결할 모델 제공자 인증(Anthropic 또는 호환 API), 그리고 로컬 karuzip-cli 설치 상태를 서로 분리해 점검하세요.
- --tools 및 --allowedTools 규칙으로 허용할 명령을 karuzip-cli 호출 범위로 제한하고, 실행 후에는 반드시 실제 출력 파일의 SHA-256을 별도 대조하세요.
011. 현재 실측 상태 안내 (인증 단계 중단 · 성공 미완료)
2026-09-12 Windows 11 Pro(26200) 환경에서 Claude Code 2.1.221과 Karuzip 2.2.3 개발 빌드로 검증을 시도했으나, OAuth session expired 인증 오류로 모델 추론에 도달하지 못했습니다. 따라서 Claude Code를 통한 Karuzip CLI 호출 성공 실측은 아직 완료되지 않았습니다. 인증 오류와 Karuzip의 압축 처리 오류를 혼동하지 않도록 이 상태를 투명하게 기록합니다.
022. Claude Code · 모델 인증 · Karuzip CLI 3단계 분리 점검
공식 웹사이트 버전 Karuzip(CLI 포함, Store 버전은 CLI 미포함)을 설치한 뒤, Claude Code 버전과 로그인 상태를 먼저 확인합니다.
karuzip-cli --json actions
claude --version
claude auth statusAnthropic 모델 외에 DeepSeek의 Anthropic 호환 API(ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic 등)를 연결할 수도 있으나, 그 구성은 'Claude Code + DeepSeek 모델' 조합으로 기록해야 하며 API 키를 문서·스크린샷·로그에 남기지 마세요.
033. 허용 명령을 한정한 비대화 실행(-p) 구성 예시
출력용 상위 폴더 out만 먼저 만들고, 전용 데모 폴더에서 --tools와 --allowedTools로 허용 범위를 좁혀 호출하는 구성 예입니다.
New-Item -ItemType Directory -Path .\out
Set-Location -LiteralPath 'C:\Karuzip-Demo'
claude -p 'task.txt의 지시를 읽고 지정된 데모 샘플만 처리하세요.' --tools 'Read,Bash' --allowedTools 'Read,Bash(./bin/karuzip-cli.exe *)' --permission-mode dontAsk --output-format json--allowedTools는 명령 허용 규칙일 뿐 OS 수준 파일시스템 격리가 아닙니다. 모델이 다른 경로 표기를 쓰면 거절될 수 있으므로, 거절 로그를 확인한 뒤 필요한 명령만 최소 범위로 허용하세요.
044. 실행 완료 후 반드시 대조할 3가지 항목
- 실제 도구 호출 확인: 에이전트 응답 텍스트만 보지 말고 도구 호출 로그에
karuzip-cli명령과 종료 코드가 있는지 확인합니다. - Receipt 일치 확인: 각 JSON Receipt의
result와out/extracted·out/selected·out/roundtrip파일 목록을 대조합니다. - 독립 SHA-256 대조: 에이전트 실행이 끝난 뒤 별도 검증 스크립트(
Get-FileHash)로 원본과 결과 파일의 해시를 비교합니다.
FAQ자주 묻는 질문
이 페이지는 왜 검색 엔진 제외(noindex)로 설정되어 있나요?
2026-09-12 시험이 OAuth 인증 만료로 중단되어 Claude Code에서 Karuzip CLI를 끝까지 실행한 성공 증거가 아직 없기 때문입니다. 실측을 완료해 검증 데이터를 공개하기 전까지 noindex 상태를 유지합니다.
Claude Code에 비밀번호가 걸린 업무용 ZIP을 바로 맡겨도 되나요?
권장하지 않습니다. 온라인 AI 모델에는 프롬프트·파일명·명령 출력이 전달될 수 있으므로 연습용 샘플로 먼저 검증하고, 비밀번호·API 키는 프롬프트나 명령 이력에 절대 넣지 마세요.
참고 자료와 확인 범위
확인 범위 및 시험 기록
2026-09-12 Windows 11 Pro(26200)에서 Claude Code 2.1.221 + Karuzip 2.2.3 개발 빌드 시험이 OAuth 인증 오류로 정지된 기록(/evidence/v223/claude.json)을 그대로 공개합니다. Anthropic 또는 DeepSeek의 공식 인증·추천 문서가 아닙니다.
- Anthropic: Claude Code 설치 및 인증 문서
- Anthropic: Claude Code 도구 권한(Permissions)
- Karuzip Claude Code 시험 기록 (인증 중단 상태, JSON)
- Karuzip CLI 상세 사용 가이드
외부 문서의 기능 범위와 정책은 운영 주체의 업데이트에 따라 바뀔 수 있습니다. 링크한 공식 안내를 함께 확인해 주세요. 내용에 오류가 있으면 정정 요청을 보내 주세요.