Dinesh3184/claude-session-sync

claude-session-sync은(는) 무엇을 하나요?

🗂️ iCloud Drive를 사용하여 macOS 및 Windows에서 Claude Code의 세션과 설정을 원활하게 동기화합니다.

개요

이 플러그인은 Claude Code의 세션 데이터를 여러 기기 간에 동기화하여 어디서나 중단 없이 작업을 계속할 수 있게 해줍니다. iCloud Drive를 동기화 저장소로 사용하며, 자동 충돌 해결 및 증분 동기화를 지원합니다.

지원 플랫폼

• macOS
• Windows (iCloud for Windows 필요)

설치 방법

1. Claude Code가 설치되어 있는지 확인합니다.
2. 저장소를 클론하거나 다운로드합니다:

git clone https://github.com/Dinesh3184/claude-session-sync.git

3. 설치 스크립트를 실행합니다:

cd claude-session-sync
./install.sh

Windows 사용자는 관리자 권한으로 PowerShell을 열고 다음을 실행하세요:

& .\install.ps1

사용법

설치가 완료되면 Claude Code가 자동으로 iCloud Drive의 동기화된 세션 폴더를 사용합니다. 별도의 추가 설정이 필요하지 않습니다.

수동 동기화

다음 명령어로 수동 동기화를 트리거할 수 있습니다:

claude-sync

동기화되는 항목

• 대화 세션 데이터
• 사용자 설정 파일
• 환경 변수 프리셋
• 프로젝트별 구성

문제 해결

iCloud Drive가 인식되지 않는 경우

iCloud Drive가 실행 중이고 로그인되어 있는지 확인하세요. macOS에서는 ~/Library/Mobile Documents/com~apple~CloudDocs/ 경로에 접근 가능해야 합니다.

충돌 해결

두 기기에서 동시에 세션을 수정한 경우, 최신 수정 시간 기준으로 자동 병합됩니다. 수동으로 해결해야 하는 충돌은 .conflict 접미사가 붙은 별도 파일로 저장됩니다.

기여

버그 신청이나 기능 제안은 이슈를 통해 제출해주세요.

라이선스

MIT