Claude 로컬 정리 도우미
macOS에서 Claude Code·Claude Desktop의 로컬 캐시·로그·로그인 상태를 안전하게 감사·백업·정리하는 스킬.
유틸리티중급★ 453⑂ 42AI 점수 9/10마지막 업데이트: 2026. 10. 19.
무엇을 해주나
- 동봉된
scripts/claude_cleanup.py로 먼저 읽기 전용 감사를 돌려 현재 상태를 보여줍니다. - 쓰기 작업 전에
~/.claude전체 복사본과~/.claude.json백업을 만들고 검증합니다. - 재생성 가능한 캐시·로그(
~/.claude/cache,~/Library/Caches/claude-cli-nodejs,~/Library/Logs/Claude등)는 자동으로 정리 목록에 넣고, 나머지는 사용자가 선택합니다. - 모든 제거는 영구 삭제가 아니라 타임스탬프 휴지통 디렉터리로 이동합니다.
projects,sessions,history.jsonl,skills,plugins,settings.json등 보호 경로는 절대 건드리지 않습니다.- 선택 사항으로 로컬 ID 로테이션, 키체인 자격증명 삭제, Claude Desktop 로그인 상태 초기화/앱 제거, 최소 프롬프트 모드(
CLAUDE_CODE_SIMPLE=1), Asia/Taipei 시간대 변경을 제공합니다. - 텔레메트리 관련 환경변수는 현재 값을 그대로 승계합니다(임의로 바꾸지 않음).
이런 분께 추천
- macOS에서 Claude Code를 오래 써서 캐시·로그가 쌓인 분
- 설정과 세션 기록은 지키면서 디스크 용량만 정리하고 싶은 분
- Claude Desktop 로그인 상태나 앱을 깔끔히 초기화하고 재설치하려는 분
rm -rf수동 삭제가 불안해 백업과 되돌릴 여지를 원하는 분
활용 예시
- "지금 Claude 관련 로컬 파일이 뭐가 쌓였는지 감사만 해줘" →
--audit만 실행해 현황 리포트. - "재생성 가능한 캐시와 로그만 정리하고 세션 기록은 남겨줘" → 자동 안전 정리 목록만 휴지통으로 이동.
- "Claude Desktop 로그인 상태를 초기화하고 앱도 지우고 싶다" → 위험 작업 항목을 개별 선택한 뒤
CONFIRM입력.
주의: Claude Code 자신이
~/.claude를 수정하면 안 되므로, 실제 정리는 Codex나 일반 터미널에서 실행해야 합니다. 밴 회피·플랫폼 리스크 관리 용도가 아닙니다.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/suyuan2022/suyuan-skill/HEAD/claude-cleanup/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
AI 스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 suyuan2022/suyuan-skill 의 claude-cleanup 폴더를 내 ~/.claude/skills/claude-cleanup/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/suyuan2022/suyuan-skill.git /tmp/suyuan-skill && mkdir -p ~/.claude/skills && cp -r /tmp/suyuan-skill/claude-cleanup ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 엽니다(macOS 기준).
- 저장소를 받습니다:
git clone https://github.com/suyuan2022/suyuan-skill.git /tmp/suyuan-skill - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills - 스킬을 복사합니다:
cp -r /tmp/suyuan-skill/claude-cleanup ~/.claude/skills/ - 스크립트가 있는지 확인합니다:
ls ~/.claude/skills/claude-cleanup/scripts/ - 먼저 감사만 실행해 봅니다:
python3 ~/.claude/skills/claude-cleanup/scripts/claude_cleanup.py --audit - 실제 정리는 Claude Code가 아닌 일반 터미널(또는 Codex) 에서 Claude 앱들을 종료한 뒤
python3 ~/.claude/skills/claude-cleanup/scripts/claude_cleanup.py로 실행하고, 목록을 읽은 다음CONFIRM을 입력합니다.
GitHub에서 원본 보기 ↗라이선스: MIT