Claude 코드 프로젝트 폴더를 세션 기록을 잃지 않고 이동하거나 이름 변경하는 방법

문제: mv로 인한 Claude Code 세션 기록 손상

Claude Code는 세션 기록을 ~/.claude/projects/에 프로젝트의 정확한 절대 경로를 식별자로 사용하여 저장합니다. 예를 들어, /Users/alex/my-project에 있는 프로젝트는 다음과 같은 세션 폴더를 가집니다: ~/.claude/projects/-Users-alex-my-project/.

mv를 사용하여 프로젝트 폴더를 이동하거나 이름을 변경하면 경로가 더 이상 일치하지 않아 모든 세션이 Claude Code에서 보이지 않게 됩니다. 데이터는 삭제되지 않지만 고아 상태가 됩니다.

해결책: clamp 도구

clamp는 폴더 이름 변경, 이동 또는 둘 다를 처리하면서 Claude Code 세션 기록을 보존하는 커뮤니티에서 만든 도구입니다.

Homebrew를 통해 설치:

brew install wsagency/tap/clamp

clamp 사용 단계

다음 단계를 순서대로 따르세요:

1. 먼저 드라이 런 실행 (변경 사항 미리보기):
   clamp --dry-run /Users/alex/old-project-name /Users/alex/documents/new-project-name
   출력에서 감지된 세션 파일과 확인된 새 경로를 확인하세요.
2. 실제 마이그레이션 실행:
   clamp /Users/alex/old-project-name /Users/alex/documents/new-project-name
   확인을 위해 y를 입력하세요.
3. 모든 것이 올바르게 적용되었는지 확인:
   clamp --list clamp --verify
4. 세션 재개:
   cd /Users/alex/documents/new-project-name
claude --continue

이미 mv를 사용한 경우

이미 mv로 폴더를 이동하여 세션 접근이 끊어진 경우 --fix 명령을 사용하세요:

clamp --fix --from /Users/alex/old-project-name --to /Users/alex/documents/new-project-name

이 도구는 프로젝트 구조를 재구성하면서 Claude Code 대화 기록에 대한 접근을 유지하려는 개발자들의 특정 문제점을 해결합니다.