Cmd. claude purge

역할

프로젝트의 로컬 세션 자료를 정리하는 터미널 CLI 명령. v2.1.288 전 이름은 claude project purge

claude purge [path]
claude project purge [path]

사용 조건

v2.1.288에서 claude project purge가 claude purge로 바뀌었습니다. 이전 이름도 계속 동작하며 안내 문구를 출력합니다. v2.1.288보다 오래된 설치본에서는 이전 이름을 씁니다.

사용 예

claude purge ~/work/repo --dry-run

v2.1.288에서 이름이 claude purge로 바뀌었습니다. claude project purge도 계속 동작하며 안내 문구를 출력하므로, v2.1.288보다 오래된 설치본에서는 아래 예의 claude purge를 이전 이름으로 바꿔 씁니다.

삭제하지 않고 계획만 미리 보기:

claude purge ~/work/repo --dry-run

단일 확인 프롬프트와 함께 삭제:

claude purge ~/work/repo

스크립트에서 확인 프롬프트 없이 삭제:

claude purge ~/work/repo --yes

모든 프로젝트 상태를 한 번에 정리(미리보기 권장):

claude purge --all --dry-run

선택 시점

1. 민감 repository 작업 후 로컬 대화/디버그 흔적 정리
2. 깨진 session/task 상태 때문에 /resume이 불안정할 때 상태 재설정
3. 장비 반납 전 프로젝트별 Claude Code state 삭제

관련 명령 선택

실행 결과와 유지 범위

실제 purge는 프로젝트의 transcript·task list·debug log·파일 편집 이력·prompt history와 ~/.claude.json의 프로젝트 항목을 삭제합니다. 위 --dry-run 예시는 삭제 대상을 미리 보여줄 뿐 삭제하지 않습니다.

claude purge(v2.1.288 전 이름은 claude project purge)는 한 프로젝트를 두고 Claude Code가 보관 중인 모든 로컬 상태를 삭제하는 CLI 서브커맨드입니다. 공식 문서 기준으로 다음 항목을 정리합니다.

• projects/ 아래의 transcript와 auto memory
• 세션별 tasks/, debug/, file-history/ 엔트리
• history.jsonl에서 해당 프로젝트와 일치하는 prompt 라인
• ~/.claude.json에 있는 해당 프로젝트의 entry

명령은 삭제하기 전에 전체 삭제 계획(deletion plan)을 출력하고 확인을 요청합니다. [path]를 생략하면 대화형 목록에서 프로젝트를 선택할 수 있습니다.

주요 옵션

주의사항

• 삭제성 명령이므로 먼저 --dry-run으로 대상 범위를 확인하세요.
• 팀 장비나 공유 계정에서는 project path를 명시하고 --all 사용을 피하세요. --all은 history.jsonl을 필터링 없이 통째로 삭제합니다.
• shell-snapshots/와 backups/는 프로젝트 범위가 아니므로 건드리지 않으며, 계획 출력에서 경고만 표시합니다.
• 주어진 path에 일치하는 상태가 없으면 명령은 status 1로 종료합니다.
• transcript가 필요한 감사/인수인계 상황에서는 export나 백업 정책을 먼저 확인하세요.
• ~/.claude.json, ~/.claude/settings.json, ~/.claude/plugins/는 auth·환경설정·설치된 플러그인을 담고 있으므로 직접 삭제하지 마세요.

공식 근거

• Changelog
• Cli Reference
• Claude Directory#Clear Local Data

전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록