저장소를 복구해도 Claude Code의 개인 설정과 작업 맥락은 빠질 수 있습니다. 팀 파일, 개인 설정, 메모리, MCP 연결, 인증 수단을 나눠 백업하고 새 환경에서 대표 작업까지 확인해야 합니다.
Commvault 발표는 지원 계획부터 확인
Commvault의 2026년 9월 30일 발표는 관리되는 Windows와 macOS 장비의 로컬 AI 데이터를 대상으로 합니다. 당시 제공 중인 것은 ChatGPT 데스크톱 앱 발견 기능이었습니다. Claude Code의 지원 대상 로컬 데이터 발견과 보호 및 복구는 향후 수개월 내 일반 제공 예정이며 구체적인 날짜는 제시하지 않았습니다. 현재 제공과 지원 계획을 구분해야 합니다. 공식 발표
백업 목록에 넣을 다섯 가지
기본 경로를 출발점으로 삼되 사용자 지정 위치와 조직 정책을 확인합니다.
- 팀 지침과 규칙은
CLAUDE.md또는.claude/CLAUDE.md,.claude/rules/를 확인합니다. 비밀값과 개인 메모를 검사한 뒤 버전관리합니다. - 설정은 팀 공통
.claude/settings.json, 사용자~/.claude/settings.json, 프로젝트 개인용.claude/settings.local.json을 구분합니다. 로컬 파일을 직접 만들었다면 Git 제외 규칙도 확인합니다. - 개인 지침은
~/.claude/CLAUDE.md,~/.claude/rules/,CLAUDE.local.md를 확인합니다.CLAUDE.local.md는 직접.gitignore에 추가해야 합니다. - MCP 정의는 프로젝트 범위의
.mcp.json과 사용자 및 로컬 범위의~/.claude.json을 구분합니다. 후자에는 로그인 상태도 들어가므로 파일 전체를 공유 저장소에 넣지 않습니다. - 자동 메모리의 기본 위치는
~/.claude/projects/<project>/memory/입니다. 기기별로 저장되며 자동 공유되지 않습니다./memory에서 위치를 찾고 파일 존재 여부도 확인합니다.
저장 범위는 설정 문서, 지침과 메모리 문서, MCP 문서를 기준으로 정리했습니다.
비밀값과 설정의 복구 경로 나누기
.mcp.json에는 환경변수 참조를 사용할 수 있습니다. 변수 이름을 남기는 것과 인증 수단을 복구하는 것은 별개입니다. 연결 정의는 비밀값을 제거해 관리하고, 토큰과 로그인은 승인된 비밀관리 수단이나 재인증 절차로 복구합니다. 환경변수 참조 안내
각 항목에 위치, 보관 방식, 복구 담당자, 마지막 검증일을 적습니다. 메모리의 고객정보도 살피고 민감한 백업에는 조직의 암호화와 접근통제 기준을 적용합니다. 토큰 값이나 설정 전체를 점검표와 화면 캡처로 공유하지 않습니다.
새 환경에서 복구 완료 확인하기
다음은 실무 점검을 위한 제안입니다. 승인된 임시 환경에서 운영 데이터를 변경하지 않는 테스트로 확인합니다.
- 기준 기록은 Claude Code 버전, 저장소 커밋, 작업 경로부터 시작합니다. 바뀐 경로와 설치 항목도 적습니다.
- 로드 확인은
/status로 설정 출처를,/context로 읽힌 지침을 확인합니다./status만으로 각 설정 키의 최종 출처까지 알 수는 없습니다. - 연결 확인은 재인증 후
/mcp에서 상태를 보고, 올바른 계정과 서버에 연결됐는지 확인합니다. 허용된 읽기 작업부터 시험합니다. - 업무 재개 확인은 민감정보 없는 예제와 대표 테스트로 진행합니다. 과거의 임시 허용 규칙도 재검토하고, 누락 항목과 실제 재개까지 걸린 시간을 기록합니다.
체크포인트는 Bash 명령이나 외부 도구가 만든 변경까지 모두 복구하지 않으며 버전관리를 대신하지 않습니다. 편집 되돌리기, Git 이력 복구, 장비 교체 후 환경 복원을 각각 확인해야 합니다. 외부 서비스에 반영한 작업에는 해당 서비스의 복구 절차가 필요할 수 있습니다. 체크포인트 제한사항
프로젝트 하나부터 시작해도 좋습니다. 대표 작업을 다시 실행하고, 빠진 항목과 재인증 절차를 복구 문서에 반영합니다.
2026년 10월 5일 문서 기준입니다. 버전과 조직 정책에 따라 적용 범위가 달라질 수 있습니다.
댓글
댓글 쓰기