- 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 skip033. 새 압축 파일 만들기 · 파일명 인코딩 · 암호 전달
압축할 때는 확장자만으로 형식을 추정하지 않으므로 --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 AI 에이전트 · MCP 서버 안내
- Karuzip 2.2.3 CLI 실측 점검 기록 (42케이스 중 41 일치, JSON)
- Karuzip 3.0.0 로컬 CLI 시험 기록 (17개 결과, JSON)
외부 문서의 기능 범위와 정책은 운영 주체의 업데이트에 따라 바뀔 수 있습니다. 링크한 공식 안내를 함께 확인해 주세요. 내용에 오류가 있으면 정정 요청을 보내 주세요.