CLI. claude project purge
프로젝트의 로컬 Claude Code 상태를 안전하게 삭제하는 CLI 서브커맨드
명령어 원본 선언
claude project purge [path]공식 설명 요약
claude project purge는 특정 프로젝트의 로컬 Claude Code 상태를 삭제하는 CLI 서브커맨드입니다.
transcript, task list, debug log, file-edit history, prompt history, ~/.claude.json의 프로젝트 entry를 정리할 때 사용합니다.
최소 지원 버전
v2.1.126이상 (공식 Changelog/CLI reference 기준)
사용법
claude project purge ~/work/repo --dry-runclaude project purge ~/work/repo -yclaude project purge --all --dry-run주요 옵션
| 옵션 | 목적 |
|---|---|
--dry-run | 실제 삭제 전 삭제 대상 미리보기 |
-y, --yes | 확인 프롬프트 생략 |
-i, --interactive | 항목별 확인 |
--all | 모든 프로젝트 대상 |
좋은 사용 예
- 민감 repository 작업 후 로컬 대화/디버그 흔적 정리
- 깨진 session/task 상태 때문에
/resume이 불안정할 때 상태 재설정 - 장비 반납 전 프로젝트별 Claude Code state 삭제
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
claude project purge | 로컬 프로젝트 상태 삭제 | transcript/state 정리 |
/clear | 현재 대화 시작점 초기화 | 같은 세션에서 새 대화 시작 |
/rewind | 대화/코드 이전 지점으로 복귀 | 특정 변경 되돌리기 |
/resume | 저장된 이전 세션 재개 | 유지해야 할 state가 있을 때 |
주의사항
- 삭제성 명령이므로 먼저
--dry-run으로 대상 범위를 확인하세요. - 팀 장비나 공유 계정에서는 project path를 명시하고
--all사용을 피하세요. - transcript가 필요한 감사/인수인계 상황에서는 export나 백업 정책을 먼저 확인하세요.
출처
- CLI reference: https://code.claude.com/docs/en/cli-reference
- Changelog: https://code.claude.com/docs/en/changelog