Cmd. claude project purge

역할

프로젝트의 로컬 세션 자료를 정리하는 터미널 CLI 명령

claude project purge [path]

사용 조건

현재 목록에 없거나 별도 릴리스로 추적하는 항목입니다. 아래 근거와 설치본을 확인하세요.

사용 예

claude project purge --help

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

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

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

claude project purge ~/work/repo

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

claude project purge ~/work/repo --yes

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

claude project purge --all --dry-run

선택 시점

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

관련 명령 선택

실행 결과와 유지 범위

실제 purge는 프로젝트의 로컬 세션 자료를 삭제하는 정리 명령입니다. 아래 --help 예시는 옵션 확인만 수행하며 삭제하지 않습니다.

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

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