무료 다운로드
자동화 · 명령줄 도구 (CLI)

Karuzip CLI 사용법: Windows PowerShell에서 JSON으로 압축 · 검사 · 해제하기

Karuzip 공식 웹사이트 설치본에는 Windows PowerShell이나 스크립트·AI 에이전트에서 호출할 수 있는 karuzip-cli가 포함되어 있습니다. 모든 작업 결과를 구조화된 JSON(ActionReceipt)과 종료 코드로 반환하므로 반복 작업을 안전하게 자동화할 수 있습니다.

작성·관리: Karuzip 문서 업데이트: 실측 근거 및 참고 자료
핵심 요약
  • karuzip-cli는 공식 웹사이트(NSIS) 설치본에 포함되어 사용자 PATH에 등록됩니다. Microsoft Store 버전에는 CLI가 포함되지 않습니다.
  • v3.0.0 기준으로 karuzip-cli --json actions 명령에서 13개 JSON 작업을 확인할 수 있으며, RAR은 읽기·해제 전용(생성 미지원)입니다.
  • 성공(0)·실패(1)·취소(2) 종료 코드와 표준 출력의 JSON Receipt(result, failure.code)를 함께 읽어 자동화 흐름을 제어하세요.

011. 설치 확인 및 사용 가능한 작업(actions) 조회

공식 웹사이트 설치본을 설치한 뒤 새 PowerShell 창을 열어 아래 명령으로 실행 파일과 사용 가능한 작업 목록을 확인합니다(관리자 권한 불필요). v3.0.0 기준 13개 작업이 JSON 배열로 반환되며, 세부 인수는 설치 폴더의 CLI-README에서 확인할 수 있습니다.

Get-Command karuzip-cli
karuzip-cli --json actions

명령을 찾을 수 없다면 Microsoft Store 버전만 설치했는지 또는 설치 전부터 열려 있던 터미널을 쓰고 있는지 확인하세요. 실행 파일만 다른 폴더로 따로 복사하면 내장 엔진을 찾지 못할 수 있으므로 설치 폴더 전체 구조를 유지하세요.

022. 정보 확인 → 목록 조회 → 무결성 검사 → 압축 풀기 순서

출력할 위치의 상위 폴더는 미리 만들어 두어야 합니다(예: .\out을 먼저 생성하고, out/extracted처럼 최종 하위 폴더는 아직 없는 상태로 지정). 상위 폴더가 없으면 안전 검사 오류(archive.destination_unsafe)가 반환됩니다.

New-Item -ItemType Directory -Path .\out
karuzip-cli --json archive.inspect --archive sample.zip
karuzip-cli --json archive.list --archive sample.zip
karuzip-cli --json archive.test --archive sample.zip
karuzip-cli --json archive.extract --archive sample.zip --destination out/extracted --conflict-policy skip

특정 파일만 꺼낼 때는 archive.list가 반환한 원래 경로를 그대로 --entry에 넘깁니다(와일드카드 *.txt는 자동 확장되지 않습니다).

karuzip-cli --json archive.extract_selected --archive sample.zip --destination out/selected --entry docs/readme.txt --conflict-policy skip

033. 새 압축 파일 만들기 · 파일명 인코딩 · 암호 전달

압축할 때는 확장자만으로 형식을 추정하지 않으므로 --format을 반드시 지정합니다. v3.0.0에서는 zip · 7z · tar · gzip · bzip2 · xz · wim · cab · iso 9가지 형식을 생성할 수 있습니다(RAR 생성 미지원). .tar.gz는 TAR로 먼저 묶은 뒤 GZIP으로 압축합니다.

karuzip-cli --json archive.compress --input source --output out/result.7z --format 7z --profile fast
karuzip-cli --json --filename-encoding cp949 archive.list --archive legacy-kr.zip
karuzip-cli --json --filename-encoding cp932 archive.extract --archive legacy-jp.zip --destination out/jp --conflict-policy skip

암호가 필요한 작업은 명령줄 인수로 비밀번호를 노출하지 않고 --password-stdin 전역 옵션을 통해 표준 입력으로 한 줄(UTF-8)을 전달합니다. 분할 압축은 ZIP·7z에서 --volume-size(512k / 10m / 100m / 512m / 650m / 700m / 1g / 2g)를 지원합니다.

044. 종료 코드와 JSON Receipt 해석하기

종료 코드의미자동화 처리 기준
0성공표준 출력 Receipt의 result와 실제 출력 파일 확인
1실패표준 출력 Receipt의 failure.code 또는 표준 오류(stderr) JSON 확인
2제어된 취소Ctrl+C 취소 완료 후 출력 위치 상태 점검

번역된 문구 대신 result와 failure.code / category / retryable 필드를 기준으로 분기하세요. 또한 archive.test 통과는 읽기·무결성 확인이지 바이러스 검사가 아니므로, 외부에서 받은 파일은 Windows 보안 검사를 별도로 거치세요.

FAQ자주 묻는 질문

Microsoft Store 버전에서도 karuzip-cli를 쓸 수 있나요?

아니요. karuzip-cli와 karuzip-mcp는 공식 웹사이트(NSIS) 설치본에만 포함되어 있습니다. 터미널이나 AI 에이전트에서 자동화하려면 공식 웹사이트 버전을 설치하세요.

CLI 명령에 비밀번호를 --password 옵션으로 바로 적을 수 있나요?

아니요. 명령줄 인수나 프로세스 목록에 비밀번호가 노출되지 않도록 --password 옵션은 제공하지 않으며, --password-stdin으로 표준 입력을 통해서만 전달합니다.

archive.test가 통과하면 파일에 바이러스가 없다는 뜻인가요?

아닙니다. archive.test는 압축 파일이 손상되지 않고 끝까지 읽히는지(CRC·무결성)를 검사할 뿐이며, 악성코드 검사나 발신자 신원 확인을 대신하지 않습니다.

참고 자료와 확인 범위

확인 범위 및 시험 기록

2026-09-12 2.2.3 개발 빌드에서 핵심 6개 Action 42케이스 실측(41개 일치, 비선두 볼륨 archive.test 제한 확인)과 2026-11-17 v3.0.0 공식 배포본의 로컬 CLI 17개 시험 결과를 근거로 작성했습니다. 현재 v3.0.0 공개본은 총 13개 CLI 작업과 9가지 생성 형식을 지원합니다.

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

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설치 없이 브라우저 도구 바로 쓰기즉시 실행