Claude Sync: 모든 기기에서 Claude Code 세션을 간편하게 동기화

Source: Dev.to

소개

Claude Code(Anthropic 공식 CLI)를 사용한다면 다음과 같은 불편을 겪어봤을 것입니다:

• 업무용 노트북에서 코딩 세션에 깊이 몰두하고 있습니다. Claude는 프로젝트 컨텍스트, 설정, 대화 기록을 기억합니다.
• 다른 기기로 전환하면 모든 것이 사라집니다—맞춤 에이전트, 프로젝트 메모리, 기록이 모두 없어져 처음부터 다시 시작해야 합니다.

Claude Sync는 암호화된 클라우드 스토리지를 이용해 ~/.claude 디렉터리를 기기 간에 동기화하는 오픈‑소스 CLI 도구입니다.

주요 기능

• 🔐 종단 간 암호화 – 파일은 업로드 전에 age 로 암호화됩니다.
• 🔑 암호 구문 기반 키 – 동일한 암호 구문으로 모든 기기에서 같은 키가 생성됩니다.
• ☁️ 멀티 클라우드 지원 – Cloudflare R2, AWS S3, Google Cloud Storage와 호환됩니다.
• 🆓 무료 티어 친화적 – 일반적인 무료 저장 용량 한도 내에서 동작합니다.
• ⚡ 간단한 CLI – push와 pull만 하면 됩니다.

동기화되는 디렉터리 구조

Claude Sync는 Claude Code가 로컬에 저장하는 모든 항목을 그대로 복제합니다:

~/.claude/
├── projects/          # 세션 파일, 각 프로젝트에 대한 자동 메모리
├── history.jsonl      # 명령 기록
├── agents/            # 사용자가 만든 맞춤 에이전트
├── skills/            # 맞춤 스킬
├── plugins/           # 설치된 플러그인
├── rules/             # 맞춤 규칙
├── settings.json      # 사용자 설정
└── CLAUDE.md          # Claude 전역 지시문

설치

npm (권장)

npm install -g @tawandotorg/claude-sync

npx (한 번만 사용)

npx @tawandotorg/claude-sync init

기본 사용법

# 변경 사항 업로드
claude-sync push

# 변경 사항 다운로드
claude-sync pull

일반적인 워크플로우:

# 하루 시작 시(또는 기기 전환 시)
claude-sync pull

# ... Claude Code를 정상적으로 사용 ...

# 하루 종료 시(또는 기기 전환 전)
claude-sync push

셸 통합 (선택)

자동 동기화를 위해 ~/.zshrc 또는 ~/.bashrc에 다음을 추가하세요:

# 셸 시작 시 자동 pull
if command -v claude-sync &> /dev/null; then
  claude-sync pull -q &
fi

# 셸 종료 시 자동 push
trap 'claude-sync push -q' EXIT

프로젝트 링크

• GitHub:
• Documentation:

기여

버그를 발견했거나 기능 아이디어가 있거나 기여하고 싶다면 GitHub에 이슈나 풀 리퀘스트를 열어 주세요.