무료 다운로드
AI 에이전트 연동 · Claude Code (실측 미완료)

Claude Code로 ZIP·7z 처리하는 절차 (실측 미완료 · 인증 단계 정지 기록)

Claude Code는 허용된 셸 명령으로 karuzip-cli를 호출해 ZIP·7z 파일을 검사·해제·압축할 수 있습니다. 다만 당사의 2026-09-12 시험은 모델 OAuth 인증 단계(OAuth session expired)에서 중단되어 실제 에이전트 실행 성공 기록이 아직 없으므로, 이 페이지는 검색 색인 제외(noindex) 상태를 유지합니다.

작성·관리: Karuzip 문서 업데이트: 실측 근거 및 참고 자료
핵심 요약
  • 실측 상태: 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 status

Anthropic 모델 외에 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의 공식 인증·추천 문서가 아닙니다.

외부 문서의 기능 범위와 정책은 운영 주체의 업데이트에 따라 바뀔 수 있습니다. 링크한 공식 안내를 함께 확인해 주세요. 내용에 오류가 있으면 정정 요청을 보내 주세요.

Karuzip 무료 다운로드

Windows 11 / 10 (64bit) · 공식 설치 파일 14.71 MB · 정식 버전 3.0.0

공식 설치 파일 다운로드 Windows 11 / 10 · 한국어 UI · CLI/MCP 포함

Windows 10 / 11 전용 프로그램입니다. 설치 파일은 Windows PC에서 이 페이지를 열어 받아 주세요.

설치 없이 브라우저 도구 쓰기 ›
  • 한국어 탐색기 우클릭 메뉴
  • 광고 · 제휴 설치 0건
  • 클라이언트 사용 기록 전송 0건
이용 요금
무료 (개인 · 기업 · 관공서)
SHA-256 해시값 (2026-11-16)
EFCE3B330BDF4C62EDA818957F41497B0E2F11F925AD903E8C4216D0485518F0
다른 설치 경로
Microsoft Store · winget ›

Windows PC로 다운로드 링크 보내기

Karuzip 데스크톱 앱은 Windows 10 / 11 전용입니다. PC 카메라로 QR 코드를 스캔하거나, 링크를 복사해 카카오톡 ‘나에게 보내기’ · 이메일로 전달하세요.

PC 카메라 · QR 스캔karuzip.com/ko/download.html · 한국어 공식 다운로드 페이지https://karuzip.com/ko/download.html
Microsoft Store에서 보기외부 이동메일 앱으로 PC에 보내기mailto설치 없이 브라우저 도구 바로 쓰기즉시 실행