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

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

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

클로드 코드(Claude Code)

— Anthropic에서 개발한 터미널 기반의 AI 코딩 에이전트로, 사용자의 로컬 파일 시스템에 직접 접근하여 코드 작성, 테스트 실행, git 제어 등을 수행하는 도구이다.

절대 경로(Absolute Path)

— 파일 시스템의 루트 디렉토리부터 특정 파일이나 폴더까지의 고유한 전체 경로를 의미한다. Claude Code는 이 경로를 세션 식별자로 사용한다.

드라이 런(Dry Run)

— 실제 파일 이동이나 데이터 수정을 수행하기 전에, 명령어가 어떻게 실행될지 시뮬레이션하여 결과를 미리 확인하는 안전 점검 단계이다.