Claude Code 프로젝트 폴더 이동 시 세션 기록 유실 방지 및 복구 방법

작성자가 직접 겪은 불편함을 바탕으로 실질적인 해결책을 제시하여 긍정적인 반응을 얻었으며, Claude Code의 세션 관리 방식에 대한 기술적 이해를 돕는 유용한 팁으로 평가받았다.

• 프로젝트 폴더를 옮기기 전에 반드시 clamp --dry-run으로 세션 이동 경로를 먼저 확인하라.
• 이미 폴더를 옮겼다면 clamp --fix 명령어를 사용하여 이전 경로와 새 경로를 연결하라.
• Homebrew를 통해 clamp를 설치하면 간편하게 세션 관리를 자동화할 수 있다.

• Claude Code는 프로젝트의 절대 경로를 세션 식별자로 사용하므로 단순 폴더 이동이나 이름 변경 시 세션 기록이 유실된 것처럼 보인다.
• 커뮤니티 도구 clamp를 사용하면 프로젝트 경로 변경에 맞춰 세션 데이터를 안전하게 마이그레이션하거나 이미 끊어진 연결을 복구할 수 있다.
• 데이터 유실을 방지하기 위해 실제 마이그레이션 전 --dry-run 옵션으로 변경 사항을 미리 확인하고 마이그레이션 후 --verify로 검증하는 과정이 권장된다.