Skillget

Kill-Claude_Code-Zombies

skill
Security Audit
Warn
Health Warn
  • License — License: Apache-2.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 7 GitHub stars
Code Warn
  • Code scan incomplete — No supported source files were scanned during light audit
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

이미 종료된 Claude Code 세션이 남긴 좀비 프로세스만 안전하게 정리하는 Windows 단일 파일 도구 (사용 중인 세션은 보호)

README.md

클로드 코드 좀비 청소기 (Claude Code Zombie Cleaner) — v1.4

Windows에서 이미 꺼진 클로드 코드(Claude Code) 창이 남긴 찌꺼기 프로그램("좀비") 만 골라서 안전하게 정리해 주는 도구입니다.
지금 사용 중인 클로드 창은 절대 건드리지 않습니다. 파일 딱 1개로 모든 기능이 동작합니다.

  • 프로젝트 이름: Kill-Claude_Code-Zombies
  • 프로그램 파일: Kill-Claude_Code-Zombies.bat (이 파일 하나가 전부입니다)
  • 대상 운영체제: Windows 10 / Windows 11
  • 추가 설치 프로그램: 없음 (Windows에 원래 있는 기능만 사용)
  • English: README.en.md

📑 목차

  1. 이 프로그램은 무엇인가요?
  2. 사전 준비물 · 필요 프로그램
  3. 다운로드 방법
  4. 설치 방법
  5. 빠른 시작 (3단계)
  6. 실행 방법
  7. 사용 방법 — 메뉴 설명
  8. 작동 방법 (원리)
  9. 명령어 (전문가용)
  10. 워크플로우
  11. 업데이트 내용 요약
  12. 보안 · 데이터 흐름
  13. 아키텍처
  14. 파일 · 문서 위치
  15. 문제 · 오류 대처
  16. 자주 묻는 질문 (FAQ)
  17. 법률 · 저작권 · 라이선스 · 상업적 이용
  18. 면책 조항 (Disclaimer)

1. 이 프로그램은 무엇인가요?

한 줄 요약: 컴퓨터에 몰래 쌓여 메모리를 잡아먹는 "죽은 클로드 코드 찌꺼기"를 찾아서 정리해 주는 청소 도구입니다.

클로드 코드(Claude Code)를 쓰다 보면, 창을 닫거나 프로그램이 갑자기 종료돼도 눈에 보이지 않는 보조 프로그램들이 컴퓨터에 계속 남아 있는 경우가 있습니다. 이것을 이 문서에서는 좀비(zombie) 라고 부릅니다. (실제 개발자들이 쓰는 컴퓨터 용어입니다 — 부모 프로그램이 죽었는데도 정리되지 않고 남은 프로그램.)

좀비가 하나둘 쌓이면:

  • 메모리(RAM)를 계속 차지해서 컴퓨터가 느려집니다.
  • 며칠씩 방치되면 수십 개, 수 GB까지 쌓일 수 있습니다.

이 도구는 그 좀비만 정확히 골라서 정리합니다.

가장 중요한 약속: 이 도구는 지금 사용 중인 클로드 코드 창은 절대 종료하지 않습니다. 오직 "부모가 죽어서 고아가 된 찌꺼기"만 정리합니다. (자세한 원리는 8. 작동 방법 참고)

1-1. 컴퓨터가 처음이신가요? (왕초보 기초)

이 문서가 어렵게 느껴진다면 아래 5개 단어만 알아두면 충분합니다.

  • 파일: 컴퓨터 안의 "서류 한 장" 같은 것입니다. 이 도구는 파일 하나(Kill-Claude_Code-Zombies.bat)가 전부입니다.
  • 폴더: 파일을 담는 "서류철·상자"입니다.
  • 두 번 클릭(더블클릭): 마우스 왼쪽 버튼을 빠르게 두 번 누르는 것 — 파일을 실행(열기)할 때 씁니다.
  • 엔터(Enter) 키: 키보드에서 가장 큰 키 중 하나로, "확인"의 의미입니다. 무언가 입력한 뒤 누릅니다.
  • 바탕화면: 컴퓨터를 켜면 처음 보이는 화면입니다. 아이콘들이 놓여 있는 곳입니다.

좀비가 뭔가요? (쉬운 비유): 식당에서 손님(클로드 코드 창)이 종업원(보조 프로그램) 여러 명을 부려서 일을 시킵니다. 손님이 계산하고 나가면(창을 닫으면) 종업원들도 같이 퇴근해야 정상입니다. 그런데 가끔 손님은 나갔는데 종업원 몇 명이 그대로 남아서 빈 테이블(메모리)만 지키는 경우가 있습니다. 이 "퇴근 못 한 종업원"이 바로 좀비입니다. 이 도구는 그 "퇴근 못 한 종업원"만 골라서 집에 보냅니다 — 지금 식사 중인 손님(사용 중인 클로드 창)의 종업원은 절대 건드리지 않습니다.

2. 사전 준비물 · 필요 프로그램

항목 필요 여부 설명
Windows 10 또는 11 ✅ 필수 이 도구는 Windows 전용입니다. (Mac·리눅스 미지원)
Windows PowerShell ✅ 필수 (이미 있음) Windows에 처음부터 들어 있는 기능입니다. 따로 설치할 필요 없습니다.
인터넷 연결 ❌ 불필요 이 도구는 인터넷을 사용하지 않습니다. 완전히 오프라인으로 동작합니다.
관리자 권한 ⚠️ 대부분 불필요 보통은 그냥 실행하면 됩니다. 드물게 "자동 청소 예약"이나 일부 프로세스 종료에서만 필요할 수 있습니다.
추가 프로그램 설치 ❌ 불필요 파이썬·노드·엑셀 등 아무것도 추가로 설치하지 않아도 됩니다.

정리: 여러분이 준비할 것은 Windows 컴퓨터 하나뿐입니다. 나머지는 이미 컴퓨터 안에 다 있습니다.

3. 다운로드 방법

이 도구는 파일 1개(Kill-Claude_Code-Zombies.bat) 만 있으면 됩니다.

방법 A. 파일을 직접 받은 경우 (USB·메신저·이메일 등)

  1. 받은 Kill-Claude_Code-Zombies.bat 파일을 원하는 폴더에 넣습니다.
    (예: 바탕화면, 문서, 또는 D:\청소도구 같은 폴더)
  2. 되도록 한 폴더 안에 두세요. 실행하면 그 폴더에 기록 파일이 함께 만들어집니다.
  3. 끝입니다. 이제 4. 설치 방법으로 넘어가세요.

방법 B. 함께 받은 문서들

이 도구에는 다음 문서가 함께 제공됩니다. 같은 폴더에 두면 편리합니다.

  • README.md / README.html — 이 문서 (전체 설명서, 한국어)
  • README.en.md / README.en.html — 영어 설명서
  • LICENSE — 라이선스(사용 권리) 문서
  • 사용법.txt — 프로그램 안에서 안내하는 짧은 사용법

보안 안내: 인터넷에서 받은 .bat 파일은 Windows가 "혹시 위험할까?" 하고 경고를 띄울 수 있습니다. 이 경고를 없애는 방법은 4. 설치 방법의 "설치(7번)"에서 자동으로 처리됩니다.

4. 설치 방법

이 도구는 사실 "설치"라는 복잡한 과정이 없습니다. 파일을 두 번 클릭하면 바로 실행됩니다. 다만, 더 편하게 쓰기 위한 선택 사항(설치 메뉴) 이 있습니다.

4-1. 꼭 해야 하는 것: 없음

Kill-Claude_Code-Zombies.bat를 두 번 클릭하면 바로 메뉴가 뜹니다. 그게 전부입니다.

4-2. 하면 편해지는 것: 메뉴 7번 "설치" (처음 한 번만 추천)

프로그램을 실행해서 메뉴에서 7 을 입력하면, 다음 두 가지를 자동으로 해 줍니다.

  1. 인터넷 보안 경고 없애기 — 인터넷에서 받은 파일에 붙는 "차단 표식"을 풀어, 실행할 때 파란 경고창이 뜨지 않게 합니다.
  2. 바탕화면 바로가기 만들기 — 바탕화면에 클로드 청소라는 아이콘을 만들어 줍니다. 다음부터는 이 아이콘만 두 번 클릭하면 됩니다.

4-3. 처음 실행 시 파란 경고창이 뜨면 (Windows의 PC 보호)

인터넷에서 받은 파일을 처음 실행하면, Windows가 파란 화면으로 "Windows의 PC 보호"라는 경고를 띄울 수 있습니다. 이때는:

  1. 파란 창에서 "추가 정보" 글자를 클릭합니다.
  2. 아래에 나타나는 "실행" 버튼을 클릭합니다.

이것은 이 도구만의 문제가 아니라, 인터넷에서 받은 모든 .bat 파일에 Windows가 기본으로 하는 안전 확인입니다. 위 메뉴 7번을 한 번 실행하면 이 경고도 사라집니다.

5. 빠른 시작 (3단계)

아무 설명도 읽기 싫고 지금 당장 쓰고 싶다면, 이 3단계만 하세요.

  1. Kill-Claude_Code-Zombies.bat 를 두 번 클릭합니다. → 검은 창에 메뉴가 뜹니다.
  2. 1 을 누르고 엔터를 칩니다. → 좀비가 몇 개 있는지 보여주고 "정리할까요?"라고 물어봅니다.
  3. Y 를 누르고 엔터를 칩니다. → 정리 끝! (좀비가 없으면 "깨끗합니다"라고 나옵니다.)

이게 전부입니다. Y를 누르기 전에는 아무것도 종료되지 않으니 마음 놓고 눌러 보세요.

6. 실행 방법

이 도구는 두 가지 방식으로 실행할 수 있습니다.

방식 1. 마우스로 두 번 클릭 (일반 사용자 · 권장)

  • Kill-Claude_Code-Zombies.bat 파일(또는 바탕화면의 클로드 청소 아이콘)을 마우스로 두 번 클릭합니다.
  • 검은 창이 뜨고 숫자 메뉴가 나옵니다.
  • 원하는 번호를 입력하고 엔터를 치면 됩니다.

방식 2. 명령어로 실행 (전문가 · 자동화용)

  • 명령 프롬프트(cmd)나 PowerShell에서 파일 경로 뒤에 옵션(플래그) 을 붙여 실행합니다.
  • 자세한 내용은 9. 명령어를 참고하세요.
  • 예: Kill-Claude_Code-Zombies.bat /kill /y (묻지 않고 바로 정리 — 자동 예약용)

왜 두 방식이 나뉘나요? 사람이 직접 두 번 클릭하면 친절한 한국어 메뉴가 뜨고, 컴퓨터가 자동(예약 작업)으로 실행하면 조용히 정리만 하도록 설계했기 때문입니다. 이렇게 하면 자동 예약이 사람 입력을 기다리며 멈추는 일이 없습니다.

7. 사용 방법 — 메뉴 설명

두 번 클릭하면 나오는 메뉴는 다음과 같습니다. 숫자를 입력하고 엔터만 치면 됩니다.

번호 이름 하는 일 안전도
1 지금 정리하기 좀비를 찾아 보여주고, Y를 눌러야만 정리합니다. 안전 (한 번 더 물어봄)
2 구경만 하기 좀비가 몇 개인지 보기만 합니다. 아무것도 종료하지 않습니다. 🟢 100% 안전
3 자동 청소 켜기 원하는 시간에 매일 자동으로 정리하도록 예약합니다. 안전
4 자동 청소 끄기 위의 자동 예약을 취소합니다. 안전
5 문제 진단 도구가 이상할 때 스스로 검사해서 해결법을 알려줍니다. 🟢 안전 (검사만)
6 도움말 자세한 사용법을 화면에 보여줍니다. 🟢 안전
7 설치 바탕화면 바로가기 생성 + 보안 경고 없애기 (처음 한 번). 안전
8 완전 삭제 준비 지우기 전 마무리 정리. 누르면 한 번 더 물어봅니다. 🟡 주의
(엔터) 닫기 창을 닫습니다. 🟢 안전

화면 색상 힌트: 🟢 초록은 "안전", 🟡 노랑은 "한 번 더 확인이 필요한 것"입니다. 잘 모르겠으면 1(정리) 을 누르세요. 정리 전에 반드시 다시 물어보므로 안전합니다.

7-1. 자동 청소 시간 정하기 (메뉴 3번)

메뉴 3번을 누르면 몇 시에 자동으로 정리할지 정할 수 있습니다. 번호로 고르거나, 원하는 시간을 자유롭게 입력할 수 있습니다.

  • 번호: 1 = 아침 9시 / 2 = 점심 12시 30분 / 3 = 저녁 7시
  • 직접 입력 (아래처럼 편하게 쓰면 알아듣습니다):
입력한 것 이렇게 알아들어요
730 아침 7시 30분
1830 저녁 6시 30분
22 밤 10시
7:30 아침 7시 30분
저녁 7시 반 저녁 7시 30분
오후 3시 오후 3시
자정 밤 12시(00:00)
정오 낮 12시(12:00)

입력하면 "→ 저녁 7시 30분(19:30)으로 예약할까요?" 하고 사람 말로 다시 물어보므로, 잘못 입력해도 안심할 수 있습니다.

8. 작동 방법 (원리)

8-1. "좀비"를 어떻게 구별하나요?

모든 프로그램에는 그것을 실행시킨 부모 프로그램이 있습니다. (예: 클로드 코드 창 → 그 안의 보조 프로그램들)

  • 부모가 살아 있으면 → 사용 중인 정상 프로그램 → 보호 (절대 안 건드림)
  • 부모가 죽어서 위로 거슬러 올라가도 살아있는 창·프로그램에 닿지 못하면 → 고아가 된 찌꺼기 → 좀비 → 정리 대상

이 도구는 각 프로그램의 가족 관계(부모 → 부모의 부모 …)를 위로 따라 올라가 봅니다. 살아있는 터미널·편집기·Windows 기본 프로그램에 닿으면 "사용 중"으로 보고 놔둡니다. 도중에 끊기면 "좀비"로 판정합니다.

8-2. 4중 안전장치

이 도구는 실수로 정상 프로그램을 종료하지 않도록 4단계 안전장치를 갖추고 있습니다.

  1. 기본은 미리보기 — 명령어로 그냥 실행하면 아무것도 종료하지 않고 목록만 보여줍니다. 실제 정리는 반드시 사용자가 선택(1 또는 Y)해야 합니다.
  2. 자기 자신 보호 — 이 청소기를 실행한 창과 그 자식 프로그램들은 절대 종료 대상에서 제외합니다. (자기가 자기를 죽이는 사고 방지)
  3. 신생 프로그램 유예 — 만들어진 지 30초 미만인 프로그램은 "이제 막 켜지는 중일 수 있다"고 보고 이번엔 건너뜁니다. (환경변수 CZK_GRACE로 조절 가능)
  4. 번호 재사용 방지 — 종료 직전에 대상을 다시 한 번 확인합니다. 그 사이 다른 프로그램이 같은 내부 번호(PID)를 넘겨받았으면 건드리지 않습니다.

추가로, 클로드 데스크톱 앱(Claude Desktop) 과 이 청소 도구 자신은 이름만 봐도 항상 제외합니다.

8-3. 무엇을 정리 대상으로 보나요?

기본적으로 클로드 코드(Claude Code) 관련 프로그램 중 고아가 된 것만 정리합니다. (실행 경로나 명령줄에 .claude, claude-code, @anthropic-ai 등 클로드 코드의 흔적이 있는 것)

전문가가 /mcp 옵션을 붙이면, 고아가 된 일반 MCP 서버 프로그램까지 대상에 포함할 수 있습니다. (기본값은 포함하지 않음 — 사용 중인 것을 실수로 종료하지 않기 위한 안전 기본값)

9. 명령어 (전문가용)

명령 프롬프트(cmd)나 PowerShell, 또는 작업 스케줄러에서 다음 옵션을 붙여 실행할 수 있습니다. 일반 사용자는 몰라도 됩니다 — 두 번 클릭 메뉴로 모든 걸 할 수 있습니다.

옵션 하는 일
(옵션 없음, 자동 실행 시) 미리보기만 — 아무것도 종료하지 않고 좀비 목록만 보여줍니다.
/kill 확인(Y/엔터)을 거쳐 좀비를 종료합니다.
/kill /y 묻지 않고 바로 종료합니다. (자동 예약 실행용)
/mcp 고아가 된 일반 MCP 서버까지 대상에 포함합니다.
/pause 끝나고 창을 닫지 않고 대기합니다. (두 번 클릭 시 결과 확인용)
/quiet 출력을 최소화합니다. (예약 실행용)
/install-schedule 매일 자동 청소 예약을 등록합니다.
/uninstall-schedule 자동 청소 예약을 삭제합니다.
/install 보안 차단 표식 해제 + 바탕화면 바로가기 생성.
/purge 예약·바로가기·기록 파일을 정리합니다. (프로그램 삭제 전 마무리)
/doctor 스스로 점검(파일 상태·예약·권한 등)합니다.

⚠️ /mcp 사용 시 주의: 이 옵션은 node·python·npx처럼 여러 프로그램이 공통으로 쓰는 실행 파일 이름 AND 명령줄에 mcp 관련 문구가 함께 있는 경우만 대상으로 삼습니다(둘 다 만족해야 함). 그래도 클로드 코드와 무관한 다른 MCP 서버가 우연히 같은 조건에 걸릴 가능성은 남아 있으니, 처음에는 /mcp 없이(또는 메뉴 2번 "구경만 하기") 먼저 목록을 확인한 뒤 사용하는 것을 권장합니다.

환경변수

이름 기본값 설명
CZK_GRACE 30 이 초(seconds)보다 젊은 프로그램은 건드리지 않습니다.
CZK_FORCE_WIZARD (없음) 1로 두면 자동 실행 환경에서도 대화형 메뉴를 강제로 띄웁니다. (테스트용)

예시

REM 아무것도 안 죽이고 목록만 보기
Kill-Claude_Code-Zombies.bat

REM 물어보고 정리
Kill-Claude_Code-Zombies.bat /kill

REM 묻지 않고 바로 정리 (자동 예약에 등록할 때)
Kill-Claude_Code-Zombies.bat /kill /y /quiet

REM 스스로 점검
Kill-Claude_Code-Zombies.bat /doctor

종료 코드(Exit code) — 자동화에서 결과 판단용: 0 = 정상, 1 = 일부 종료 실패, 2 = 사용자가 취소, 3 = 내부 오류.

10. 워크플로우

[두 번 클릭]
     │
     ▼
 (검은 창 + 숫자 메뉴 표시)
     │
     ├─ 1  지금 정리 ──▶ 검사 ──▶ 좀비 목록 표시 ──▶ "정리할까요? Y/엔터"
     │                                                    │
     │                                        Y ──▶ 종료 실행 ──▶ 결과 표시 + 결과 파일 저장
     │                                        엔터 ──▶ 취소 (아무것도 안 함)
     │
     ├─ 2  구경만 ─────▶ 검사 ──▶ 개수만 표시 (종료 안 함)
     │
     ├─ 3  자동 켜기 ──▶ 시간 입력 ──▶ 확인 ──▶ 매일 예약 등록 ──▶ "다음 실행" 표시
     │
     ├─ 4  자동 끄기 ──▶ 예약 삭제
     │
     ├─ 5  진단 ───────▶ 파일·예약·권한·좀비 상태 점검 결과 표시
     │
     ├─ 6  도움말 ─────▶ 사용법 표시
     │
     ├─ 7  설치 ───────▶ 보안표식 해제 + 바탕화면 바로가기 생성
     │
     └─ 8  완전삭제준비 ▶ "정말? Y/엔터" ──▶ (Y) 예약·바로가기·기록 정리

자동 예약 흐름 (메뉴 3번으로 켠 경우)

매일 정한 시각 (또는 로그인 시) ──▶ 컴퓨터가 조용히 Kill-Claude_Code-Zombies.bat /kill /y /quiet 실행
                                     ──▶ 좀비 있으면 정리, 없으면 아무 일도 안 함 ──▶ 로그에 기록

11. 업데이트 내용 요약

아래는 기능이 추가되어 온 순서입니다. 현재 버전은 v1.4입니다. 버전 이름을 클릭하면 펼쳐집니다.

v1.0 — 기초

좀비 탐지·종료 엔진, 미리보기 기본값, 4중 안전장치(자기 보호·유예·번호 재사용 방지·미리보기), 기술 로그 기록.

v1.1 — 초보자화

한국어 대화형 마법사(두 번 클릭), 회수 메모리(MB) 표시, 사람이 읽기 쉬운 결과 요약 파일, 로그 자동 정리, 자동 청소 예약(작업 스케줄러).

v1.2 — 통합·안내

모든 기능을 숫자 메뉴 하나로 통합(파일 1개 완성), 첫 실행 시 자동 안내, 상단 상태판 + 버전 표기, 문제 진단(5번), 오류 발생 시 신고 파일 자동 열기.

v1.3 — 시간 자유 입력

자동 청소 시간을 1830 / 22 / 저녁 7시 반 / 오후 3시 처럼 자유롭게 입력, 확인 되묻기, 예약 시간·"다음 실행" 표시.

v1.4 — 안전한 선택 (현재 버전)

완전 삭제(8번)에 확인 게이트(기본 = 취소), "모르겠으면 1번" 추천 힌트, 안전(초록)/주의(노랑) 색상 구분, 바탕화면 바로가기 식별 아이콘.

12. 보안 · 데이터 흐름

이 도구는 개인정보 보호와 안전을 매우 보수적으로 설계했습니다.

  • 인터넷 미사용: 이 도구는 어떤 데이터도 인터넷으로 보내지 않습니다. 서버·계정·로그인이 전혀 없습니다. 완전 오프라인으로 동작합니다.
  • 개인정보 수집 없음: 사용자의 이름·이메일·문서 내용 등을 수집하거나 저장하지 않습니다.
  • 기록 파일의 내용: 정리 기록(claude-zombie-kill.log)에는 종료된 프로그램의 내부 번호(PID)·이름·실행 경로 일부만 기록됩니다. 이 파일은 여러분 컴퓨터 안에만 있고, 밖으로 나가지 않습니다. 512KB가 넘으면 오래된 내용은 자동으로 잘라 냅니다.
  • 비밀번호·키 미취급: 이 도구는 비밀번호·API 키·인증 정보를 읽거나 쓰지 않습니다.
  • 권한 최소 사용: 대부분의 작업은 관리자 권한 없이 동작합니다. 종료 대상도 "여러분이 실행한 클로드 코드 관련 프로그램" 범위로 한정됩니다.

데이터 흐름 요약

Windows에게 "지금 켜져 있는 프로그램 목록 알려줘" 라고 물어봄 (읽기)
        │
        ▼
그중 고아가 된 클로드 코드 찌꺼기만 골라냄 (컴퓨터 안, 메모리에서 계산)
        │
        ▼
사용자가 정리를 선택하면 → 해당 프로그램만 종료 (쓰기 = 종료 명령)
        │
        ▼
결과를 내 컴퓨터의 기록 파일에 남김 (로컬 저장, 외부 전송 없음)

⚠️ 주의: 프로그램을 강제 종료하면, 그 프로그램이 저장하지 않은 작업 내용이 사라질 수 있습니다. 다만 이 도구는 이미 부모가 죽은 좀비만 대상으로 하므로, 정상적으로 사용 중인 작업이 사라질 가능성은 매우 낮습니다. 그래도 중요한 작업은 미리 저장해 두는 것을 권장합니다.

13. 아키텍처

구조를 한마디로: .bat 껍데기 + PowerShell 알맹이가 한 파일 안에 함께 들어 있는 단일 파일 프로그램입니다. (외부 의존성 0)

  • 폴리글랏(polyglot) 단일 파일: Kill-Claude_Code-Zombies.bat의 맨 앞 몇 줄은 Windows 명령(cmd)이 읽는 부분이고, 이 부분이 나머지 전체를 PowerShell 코드로 실행시킵니다. 그래서 파일 하나로 두 언어가 협력합니다.
  • 프로세스 정보 수집: Windows의 표준 기능(WMI/CIM Win32_Process)으로 현재 프로그램 목록과 가족 관계를 읽습니다.
  • 판정 로직: 가족 관계를 위로 따라 올라가는 방식으로 "좀비/보호/유예"를 분류합니다.
  • 종료: PowerShell의 Stop-Process로, 재확인을 거친 뒤에만 종료합니다.
  • 예약: Windows 작업 스케줄러(Register-ScheduledTask, 실패 시 고전 schtasks.exe로 대체)에 등록합니다.
  • 출력: 화면(콘솔)에는 한국어 안내, 파일에는 기록/결과를 남깁니다.

동작 모드는 두 가지: ① 사람이 두 번 클릭 → 대화형 메뉴, ② 인자·자동 실행 → 조용한 처리. 입력이 리다이렉트(파이프·예약)되면 자동으로 조용한 모드가 되어, 예약 작업이 사람 입력을 기다리다 멈추는 일을 방지합니다.

14. 파일 · 문서 위치

모든 파일은 Kill-Claude_Code-Zombies.bat가 있는 같은 폴더에 만들어집니다.

파일 이름 종류 설명
Kill-Claude_Code-Zombies.bat 프로그램 본체. 이 파일 하나가 전부입니다.
claude-zombie-kill.log 자동 생성 기술 기록(로그). 512KB 초과 시 자동 정리.
최근-청소-결과.txt 자동 생성 마지막 정리 결과를 사람이 읽기 쉽게 요약.
오류-신고.txt 자동 생성 오류가 났을 때만 생성. AI에게 붙여넣어 도움받을 수 있음.
README.md / README.html 문서 전체 설명서(한국어) — 이 문서.
README.en.md / README.en.html 문서 영어 설명서.
LICENSE 문서 라이선스(사용 권리) 문서.
사용법.txt 문서 프로그램이 안내하는 짧은 사용법.
클로드 청소.lnk 자동 생성 바탕화면 바로가기(메뉴 7번 실행 시).

15. 문제 · 오류 대처

문제: 두 번 클릭했더니 검은 창이 잠깐 떴다가 바로 사라져요

  • 정상적으로 실행됐지만 결과를 볼 새도 없이 닫힌 경우일 수 있습니다.
  • 해결: 두 번 클릭하면 나오는 메뉴는 원래 닫기 전까지 유지됩니다. 만약 명령어로 실행 중이라면 뒤에 /pause를 붙여 보세요.

문제: 파란 경고창("Windows의 PC 보호")이 떠요

  • 인터넷에서 받은 파일에 Windows가 붙이는 기본 안전 확인입니다.
  • 해결: 파란 창의 "추가 정보" → "실행" 을 누르세요. 메뉴 7번(설치) 을 한 번 실행하면 이 경고가 사라집니다.

문제: "실패"라고 나와요 (일부 프로그램을 종료하지 못함)

  • 드물게 관리자 권한이 필요한 프로그램일 수 있습니다.
  • 해결: Kill-Claude_Code-Zombies.bat를 마우스 오른쪽 클릭 → "관리자 권한으로 실행" 으로 다시 실행하세요.

문제: 자동 청소 예약이 "실패"라고 나와요

  • 예약 등록에 권한이 부족한 경우입니다. (이 도구는 실패를 거짓으로 성공이라 표시하지 않고 정직하게 알려 줍니다.)
  • 해결: 오른쪽 클릭 → "관리자 권한으로 실행" 후 다시 시도하세요.

문제: 도구가 이상하게 동작해요 / 뭔가 깨진 것 같아요

  • 해결: 메뉴 5번(문제 진단) 을 누르세요. 파일 상태·보안 표식·예약 상태 등을 스스로 검사해서 "정상/문제 + 해결법"을 알려 줍니다.

문제: 갑자기 오류 메시지가 뜨고 멈췄어요

  • 이 경우 오류-신고.txt 파일이 자동으로 만들어지고 메모장으로 저절로 열립니다.
  • 해결: 그 파일 내용을 복사해서 AI(클로드 등)에게 붙여넣고 "이 오류 해결해줘" 라고 물어보세요. 원인과 해결법을 안내받을 수 있습니다.

16. 자주 묻는 질문 (FAQ)

Q. 실수로 정리를 눌렀어요! 사용 중인 클로드가 꺼지나요?
A. 아닙니다. 이 도구는 부모가 죽은 좀비만 정리합니다. 또한 Y를 누르기 전에는 아무것도 종료되지 않습니다.

Q. 매일 자동으로 돌려도 괜찮나요?
A. 네. 좀비가 없으면 아무 일도 하지 않습니다. 매일 돌려도 부작용이 없습니다.

Q. 이 도구가 제 문서나 코드를 지우나요?
A. 아닙니다. 이 도구는 파일을 지우지 않습니다. 오직 메모리에 떠 있는 "죽은 프로그램(좀비)"만 종료합니다. (단, 종료된 프로그램이 저장하지 않은 작업은 사라질 수 있으니, 중요한 작업은 미리 저장하세요.)

Q. 인터넷 없이도 되나요?
A. 네. 이 도구는 인터넷을 전혀 쓰지 않습니다.

Q. Mac이나 리눅스에서도 되나요?
A. 아니요. Windows 전용입니다.

Q. 다른 컴퓨터에 옮기려면요?
A. Kill-Claude_Code-Zombies.bat 파일 하나만 복사해 가면 모든 기능을 그대로 쓸 수 있습니다.

Q. 이 도구를 완전히 지우려면요?
A. 메뉴 8번(완전 삭제 준비) 을 실행한 뒤(자동 예약·바로가기·기록이 정리됩니다), 파일과 폴더를 휴지통에 버리면 됩니다.

Q. 명령어를 꼭 알아야 하나요?
A. 아닙니다. 두 번 클릭 메뉴만으로 모든 기능을 쓸 수 있습니다. 명령어는 자동화를 원하는 전문가용입니다.

17. 법률 · 저작권 · 라이선스 · 상업적 이용

본 프로젝트는 오픈소스 라이선스인 Apache License 2.0 으로 배포됩니다. 아래 18. 면책 조항과 함께 읽어 주세요. 정식 전문은 함께 제공되는 LICENSE 파일에 있으며, 이 요약과 본문이 다를 경우 LICENSE 파일이 우선합니다.

17-1. 저작권 (Copyright)

  • Copyright © 2026 SoDam AI Studio.
  • 본 소프트웨어(Kill-Claude_Code-Zombies.bat)와 함께 제공되는 모든 문서는 Apache License, Version 2.0 하에 라이선스됩니다.

17-2. 허용되는 것 (Permissions)

Apache License 2.0에 따라 누구나 다음을 할 수 있습니다.

  • ✅ 상업적 이용 (판매·유료 서비스 포함).
  • ✅ 수정 및 2차적 저작물 작성.
  • ✅ 배포 및 재배포.
  • ✅ 특허 사용 (기여자가 보유한 관련 특허의 무상 라이선스 포함).
  • ✅ 사적 이용.

17-3. 지켜야 할 조건 (Conditions)

  • 📌 배포 시 라이선스 사본(LICENSE)과 저작권 고지를 포함해야 합니다.
  • 📌 파일을 수정한 경우, 변경했다는 사실을 명시해야 합니다.
  • 📌 원본에 NOTICE 파일이 있다면 그 고지를 유지해야 합니다.
  • ⛔ 제한: 상표 사용권은 부여되지 않으며, 어떠한 보증도 없고, 기여자는 책임을 지지 않습니다(아래 18번 참고).

17-4. 제3자 구성요소 (Third-Party Components)

  • 이 도구는 Windows에 기본 내장된 구성요소(Windows PowerShell, WMI/CIM, 작업 스케줄러, Windows Script Host)만 사용합니다.
  • 외부에서 가져온 제3자 코드나 라이브러리를 포함하지 않습니다. 따라서 이 도구를 사용하는 데에 별도의 제3자 오픈소스 라이선스 의무가 발생하지 않습니다.
  • Windows 구성요소의 사용은 사용자의 Windows 라이선스(EULA)를 따릅니다.

17-5. 상표 고지 (Trademark Notice)

  • "Claude", "Claude Code", "Anthropic" 은 Anthropic PBC의 상표입니다.
  • 본 도구는 비공식·독립 프로젝트이며, Anthropic과 어떠한 제휴·후원·보증 관계도 없습니다. 도구 이름에 "Claude Code"가 포함된 것은 호환 대상(정리 대상)을 설명하기 위한 것일 뿐입니다.

17-6. AI 생성물 관련 고지 (AI-Generated Content Notice)

  • 본 소프트웨어와 문서는 AI 코딩 도구(Claude Code 등)의 도움을 받아 개발되었습니다.
  • AI가 생성한 코드·문서의 저작권 귀속, 기존 저작물과의 유사성 여부, 상업적 이용 가능 범위는 아직 법적으로 완전히 확립되지 않은 영역입니다.
  • 이 프로젝트를 상업적 목적, 재배포, 고객사 납품 등에 사용하기 전에는 필요하다면 법률 전문가의 검토를 받으시길 권장합니다.
  • ⚠️ 이 고지는 법률 자문이 아니며, 확정된 법적 판단을 대신하지 않습니다.

18. 면책 조항 (Disclaimer)

⚠️ 이 도구는 프로그램을 강제로 종료합니다. 아래 내용에 동의하는 경우에만 사용하세요.

  • 본 소프트웨어는 "있는 그대로(AS-IS)" 제공되며, 상품성·특정 목적 적합성·비침해를 포함한 어떠한 종류의 명시적·묵시적 보증도 하지 않습니다.
  • 저작권자는 본 소프트웨어의 사용 또는 사용 불능으로 인해 발생하는 어떠한 손해(데이터 손실, 저장하지 않은 작업의 소실, 프로그램·업무 중단, 직접·간접·부수적·특별·결과적 손해 등)에 대해서도 책임지지 않습니다.
  • 본 소프트웨어의 사용에 따른 모든 위험과 책임은 전적으로 사용자에게 있습니다.
  • 본 도구는 프로세스를 강제 종료하므로, 종료된 프로그램이 저장하지 않은 데이터가 사라질 수 있습니다. 중요한 작업은 반드시 미리 저장하고, 처음에는 메뉴 2번(구경만 하기) 으로 대상을 확인한 뒤 사용하시길 권장합니다.
  • 이 도구는 투자·법률·의료 등 전문적 조언을 제공하지 않으며, 컴퓨터 유지관리를 위한 참고용 유틸리티입니다.

문서 버전: v1.4 기준 · 한국어(원본) · 이 문서(README.md)와 README.html의 내용은 동일합니다.

Reviews (0)

No results found