스크립트와 AI 도구가 명확한 경계 안에서
로컬 파일 작업을 실행하도록 연결하세요
공식 웹사이트 버전(3.0.0)에는 karuzip-cli(13개 작업)와 로컬 stdio 기반 karuzip-mcp(21개 도구)가 포함되어 있으며 한국어 도움말(--locale ko)을 기본 지원합니다. 현재 공개된 Microsoft Store 버전에는 포함되지 않습니다(3.0의 Store 지원은 실제 패키지로 검증 중이며, Store 페이지 표시 버전을 기준으로 합니다).
AI 에이전트 · CLI · 로컬 안전 경계 흐름
네트워크 포트를 열지 않고 표준 입출력(stdio)으로만 통신하며, 모든 쓰기 작업은 허용 루트와 미리 보기 확인 토큰을 통과해야 실행됩니다.
좁은 화면에서는 구조도를 좌우로 밀어 전체 흐름을 확인하세요.
CLI: 13가지 고정 작업 식별자와 실전 예시
종료 코드 0 성공 · 1 실패 · 2 취소. 전역 옵션(--locale ko, --filename-encoding, --password-stdin)과 JSON 영수증(Receipt)으로 스크립트에서 안전하게 제어합니다.
karuzip-cli --json actions # 압축 파일 (6) : archive.inspect / archive.list / archive.test # archive.extract / archive.extract_selected / archive.compress # 파일 목록 만들기 (1) : file.collect # 이미지 일괄 처리 (1) : image.transform # PDF 일괄 처리 (5) : pdf.merge / pdf.extract / pdf.split / pdf.reorder / pdf.compress
--locale ko) 및 인코딩 지정(--filename-encoding cp949) 예시
# 한국어 CLI 도움말 확인 karuzip-cli --locale ko --help # 구형 한글 ZIP을 한국어(CP949)로 먼저 목록 확인한 뒤 기존 파일 보호(skip)로 추출 karuzip-cli --json --filename-encoding cp949 archive.list --archive 보고서_2026.zip karuzip-cli --json --filename-encoding cp949 archive.extract --archive 보고서_2026.zip --destination out/보고서_2026 --conflict-policy skip # 폴더 내 파일 메타데이터·SHA-256 요약 수집 (최대 1,024개 항목 JSON) karuzip-cli --json file.collect --input ./납품자료 > out/inventory.json
21개 MCP 도구와 3단계 권한 경계
--allow-root(또는 클라이언트 roots)가 없으면 읽기·관리 6개 도구만 노출되며, 허용 루트를 지정했을 때만 목록 수집 1개와 2단계 확인 토큰 기반 쓰기 14개 도구가 활성화됩니다.
| 권한 구분 | MCP 도구 및 작업 | 기본 동작 · 검증 절차 |
|---|---|---|
| 항상 사용 (6) | karuzip_archive_inspect — 압축 파일 형식·항목 요약 확인 |
--allow-root 및 쓰기 확인 토큰 불필요 |
| 항상 사용 (6) | karuzip_archive_list — 항목 목록 조회 (기본 2,000건 · 생략 여부 통지) |
--allow-root 및 쓰기 확인 토큰 불필요 |
| 항상 사용 (6) | karuzip_archive_test — 압축 파일 손상·무결성 검사 |
--allow-root 및 쓰기 확인 토큰 불필요 |
| 항상 사용 (6) | karuzip_actions_describe · karuzip_receipt_get · karuzip_task_cancel — 작업 스키마·처리 영수증 조회·취소 |
--allow-root 및 쓰기 확인 토큰 불필요 |
| 허용 루트 읽기 (1) | karuzip_file_collect — 파일 목록 메타데이터·SHA-256 요약 수집 (최대 1,024개) |
허용 루트(roots) 필수 · 쓰기 확인 토큰 불필요 |
| 허용 루트 쓰기 (14) | karuzip_archive_extract · karuzip_archive_extract_selected · karuzip_archive_compress — 압축 풀기·선택 추출·새 압축 만들기 |
허용 루트 필수 + 미리 보기 후 동일 조건 confirm_token 확인 |
| 허용 루트 쓰기 (14) | karuzip_image_transform — 이미지 형식 변환·크기 조절·회전 |
허용 루트 필수 + 미리 보기 후 동일 조건 confirm_token 확인 |
| 허용 루트 쓰기 (14) | karuzip_pdf_merge · karuzip_pdf_extract · karuzip_pdf_split · karuzip_pdf_reorder · karuzip_pdf_compress — PDF 병합·추출·분할·순서 변경·압축 |
허용 루트 필수 + 미리 보기 후 동일 조건 confirm_token 확인 |
| 허용 루트 쓰기 (14) | karuzip_image_transform_batch · karuzip_pdf_merge_batch · karuzip_pdf_extract_batch · karuzip_pdf_split_batch · karuzip_pdf_reorder_batch — 이미지·PDF 일괄 처리 (5종) |
허용 루트 필수 + 미리 보기 후 동일 조건 confirm_token 확인 |
임의의 셸 명령 실행이나 파일 본문 내용을 AI로 반환하는 도구는 제공하지 않습니다.
Claude Code · Codex · Cursor 설정
네트워크 포트를 열지 않고 로컬 표준 입출력(stdio)으로만 연결합니다. 작업 폴더만 --allow-root로 지정하세요.
stdio 서버 연결 설정
C:\Users\이름)나 드라이브 루트(C:\)를 기본 허용 경로로 지정하지 마세요. --allow-root 미지정 시 읽기·관리 6개 도구만 노출되며, 지정 시 쓰기 도구를 포함한 21개 도구가 활성화됩니다.미리 보기 확인 토큰 및 암호 별칭
AI 에이전트가 임의로 파일을 덮어쓰거나 평문 암호를 읽지 못하도록 설계된 보호 장치입니다.
파일을 생성하는 모든 쓰기 도구는 먼저 미리 보기를 호출해 확인 토큰을 발급받아야 실행됩니다. AI 클라이언트의 자체 승인만으로 이 검사를 건너뛸 수 없습니다.
karuzip-mcp는 Windows 자격 증명 관리자에 등록된 별칭(alias)으로 암호를 참조하므로 대화 프롬프트에 평문 암호를 노출할 필요가 없습니다.
MCP 미디어 입력은 무결성이 검증된 비암호화 단일 ZIP32(ZIP64 제외 · 최대 4개 소스 · 16개 항목)만 허용하며, GUI의 64개 · 7z 허용 기준과 구분해 적용됩니다.
Karuzip 무료 다운로드
Windows 11 / 10 (64bit) · 공식 설치 파일 14.71 MB · 정식 버전 3.0.0
Windows 10 / 11 전용 프로그램입니다. 설치 파일은 Windows PC에서 이 페이지를 열어 받아 주세요.
설치 없이 브라우저 도구 쓰기 ›- 한국어 탐색기 우클릭 메뉴
- 광고 · 제휴 설치 0건
- 클라이언트 사용 기록 전송 0건
- 이용 요금
- 무료 (개인 · 기업 · 관공서)
- SHA-256 해시값 (2026-11-16)
- EFCE3B330BDF4C62EDA818957F41497B0E2F11F925AD903E8C4216D0485518F0
- 다른 설치 경로
- Microsoft Store · winget ›