AI 스킬마트스킬 둘러보기명령어프로그램배우기스킬이 뭐예요?
 
← 목록으로

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 수동 삭제가 불안해 백업과 되돌릴 여지를 원하는 분

활용 예시

  1. "지금 Claude 관련 로컬 파일이 뭐가 쌓였는지 감사만 해줘" → --audit만 실행해 현황 리포트.
  2. "재생성 가능한 캐시와 로그만 정리하고 세션 기록은 남겨줘" → 자동 안전 정리 목록만 휴지통으로 이동.
  3. "Claude Desktop 로그인 상태를 초기화하고 앱도 지우고 싶다" → 위험 작업 항목을 개별 선택한 뒤 CONFIRM 입력.

주의: Claude Code 자신이 ~/.claude를 수정하면 안 되므로, 실제 정리는 Codex나 일반 터미널에서 실행해야 합니다. 밴 회피·플랫폼 리스크 관리 용도가 아닙니다.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/suyuan2022/suyuan-skill/HEAD/claude-cleanup/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ 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자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 엽니다(macOS 기준).
  2. 저장소를 받습니다: git clone https://github.com/suyuan2022/suyuan-skill.git /tmp/suyuan-skill
  3. 스킬 폴더를 만듭니다: mkdir -p ~/.claude/skills
  4. 스킬을 복사합니다: cp -r /tmp/suyuan-skill/claude-cleanup ~/.claude/skills/
  5. 스크립트가 있는지 확인합니다: ls ~/.claude/skills/claude-cleanup/scripts/
  6. 먼저 감사만 실행해 봅니다: python3 ~/.claude/skills/claude-cleanup/scripts/claude_cleanup.py --audit
  7. 실제 정리는 Claude Code가 아닌 일반 터미널(또는 Codex) 에서 Claude 앱들을 종료한 뒤 python3 ~/.claude/skills/claude-cleanup/scripts/claude_cleanup.py 로 실행하고, 목록을 읽은 다음 CONFIRM을 입력합니다.