Claude Code 환경을 새 컴퓨터로 이전하는 방법
개요
새 컴퓨터로 전환할 때, Claude Code의 설정, 메모리, 프로젝트 컨텍스트를 함께 가져가고 싶을 것입니다. 무엇을 백업하고 어떻게 복원하는지 알아보겠습니다.
백업할 것들
Claude Code는 모든 것을 ~/.claude/에 저장합니다. 전부 다 필요하진 않습니다 — 중요한 것만 정리했습니다:
필수
| 경로 | 설명 |
|---|---|
~/.claude/CLAUDE.md | 모든 프로젝트에 적용되는 전역 지시사항 |
~/.claude/settings.json | 권한, 허용/거부 도구 및 기타 설정 |
~/.claude/projects/ | 프로젝트별 메모리, 지시사항, 컨텍스트 |
있으면 좋은 것
| 경로 | 설명 |
|---|---|
~/.claude/history.jsonl | 대화 히스토리 |
건너뛸 것
| 경로 | 설명 |
|---|---|
~/.claude/cache/ | 자동으로 재생성됨 |
~/.claude/debug/ | 디버그 로그 |
~/.claude/session-env/ | 임시 세션 데이터 |
~/.claude/shell-snapshots/ | 셸 상태 스냅샷 |
~/.claude/todos/ | 이전 세션의 작업 목록 |
~/.claude/statsig/ | 분석 캐시 |
~/.claude/telemetry/ | 텔레메트리 데이터 |
~/.claude/file-history/ | 파일 편집 히스토리 |
~/.claude/backups/ | 자동 생성 백업 |
~/.claude/plans/ | 세션 계획 (임시) |
프로젝트 레벨 파일
Claude Code는 프로젝트 디렉토리의 CLAUDE.md 파일도 읽습니다. 프로젝트가 git에 있다면 이미 백업되어 있습니다. 각 저장소의 루트에 위치하며 프로젝트별 지시사항을 담고 있습니다.
이전 단계
1. 이전 컴퓨터에서
# 필수 파일 복사
tar czf claude-code-backup.tar.gz \
~/.claude/CLAUDE.md \
~/.claude/settings.json \
~/.claude/projects/ \
~/.claude/history.jsonl2. 새 컴퓨터에서
# Claude Code 설치
npm install -g @anthropic-ai/claude-code
# 백업 복원
tar xzf claude-code-backup.tar.gz -C /
# 확인
cat ~/.claude/CLAUDE.md
cat ~/.claude/settings.json
ls ~/.claude/projects/3. 작동 확인
아무 프로젝트 디렉토리에서 Claude Code를 시작합니다. 전역 지시사항과 프로젝트별 메모리가 자동으로 적용되어야 합니다.
cd your-project/
claude메모리 작동 방식
Claude Code는 ~/.claude/projects/에 파일 기반 메모리 시스템을 저장합니다. 각 프로젝트는 프로젝트 경로 이름으로 된 자체 디렉토리를 가지며 다음을 포함합니다:
MEMORY.md— 모든 메모리 파일의 인덱스- 개별 메모리 파일 — 사용자 선호도, 프로젝트 컨텍스트, 피드백, 참조
이 메모리는 대화 간에 유지되며 Claude Code가 사용자의 선호도, 프로젝트 결정사항, 이전 피드백을 기억하도록 합니다. projects/ 디렉토리를 이전하면 Claude Code가 작업 방식에 대한 모든 것을 기억합니다.
팁
- 전부 백업하지 마세요 —
~/.claude/의 대부분은 자동으로 재생성되는 임시 데이터입니다. 필수 항목만 백업하면 깔끔하게 유지됩니다. - 설정을 확인하세요 — 복원 후
settings.json의 경로와 권한이 새 컴퓨터에서도 맞는지 확인하세요. - 프로젝트 경로가 중요합니다 —
projects/디렉토리는 프로젝트 경로를 디렉토리 이름으로 사용합니다. 새 컴퓨터에서 프로젝트가 다른 경로에 있다면~/.claude/projects/아래의 디렉토리 이름을 변경해야 할 수 있습니다.
