claude-autosync — Claude 코드 규칙 및 메모리를 여러 기기에서 동기화

만약 한 대의 컴퓨터(노트북, 데스크톱, 업무용 PC, 서버 등)가 아닌 여러 기기에서 Claude Code를 사용한다면, 아마 이런 경험을 했을 것입니다. 즉, 당신의 CLAUDE.md 규칙과 메모리가 오직 한 대의 기기에만 존재한다는 것입니다. 다른 모든 기기는 마치 아무것도 모르는 것처럼 시작합니다. 매번 당신의 선호 사항을 다시 설명하고 같은 컨텍스트를 반복해서 가르쳐야 합니다.
claude-autosync가 이 문제를 해결해 줍니다. 이것은 전역 CLAUDE.md와 프로젝트별 메모리를 git 저장소에 심볼릭 링크(symlinks)로 연결하여 자동 동기화합니다. 세션 시작 시에는 pull을 하고, 세션 종료 시에는 commit 및 push를 수행합니다. 하나의 두뇌가 모든 곳에 존재하게 됩니다.
개인 정보 보호: 이 도구 자체는 어떠한 데이터도 저장하지 않습니다. 당신의 규칙과 메모리는 나에게나 공유된 것이 아니라 오직 당신 자신의 개인 저장소에 존재합니다. 기기별 고유 정보(경로, 호스트, 비밀값)는 gitignore 처리되어 동기화되지 않는 local.md 파일에 들어갑니다.
보안: 공개/오픈 소스 저장소에서 작업할 때도 사용하기 안전합니다.
프로젝트별 메모리는 프로젝트 내부의 파일을 건드리지 않는 '중앙(central)' 모드로 기본 설정되며, 선택적인 '프로젝트 내부(in-project)' 모드는 (gh를 통해 검증되어) 공개 저장소에서는 자동으로 거부되므로 개인적인 메모가 유출될 수 없습니다. 또한, 동기화는 깨진 파일을 커밋하는 대신 병합 충돌(merge conflicts)이 발생하면 중단됩니다.
에이전트 자체 설치: 직접 설정할 필요가 거의 없습니다. Claude Code를 README 파일로 지정하기만 하면 됩니다. 여기에 'AI 에이전트를 위한 섹션'이 있는데, 이 부분이 당신의 개인 저장소를 생성하고, OS를 감지하며, 설치 프로그램을 실행하고, 모든 것을 검증합니다. 수동 단계가 전혀 필요하지 않습니다.
알아두면 좋은 점: 반드시 자신만의 개인 저장소(절대 공개해서는 안 됨)를 사용하고, 원시 비밀값(raw secrets)을 동기화 파일에 넣지 마세요. 프로젝트별 기능이 풍부한 도구들은 bash 기반입니다 (Windows의 경우 WSL을 사용해야 하며, 심볼릭 링크에는 개발자 모드가 필요합니다). 아직 초기 단계이니 신뢰하기 전에 스크립트를 훑어보는 것이 좋습니다.
MIT 라이선스입니다. 피드백 환영합니다.
업데이트 — v0.3.0이 출시되었습니다: 이제 CLAUDE.md와 메모리뿐만 아니라 당신의 기술(skills)과 슬래시 명령어(slash commands)도 동기화합니다.
이는 선택적입니다. ~/.claude/skills 또는 ~/.claude/commands 아래에 있는 내용은 명시적으로 승격시키지 않는 한 아무것도 동기화되지 않으므로, 기기별 고유하거나 개인적인 기술은 로컬로 유지됩니다. 대화형 체크리스트를 위해 item-sync.sh skill을 실행하거나, 비헤드리스/에이전트 설정을 위해 이름을 전달할 수 있습니다.

새로운 기기에서는 동기화된 스킬(skills)을 자동으로 가져옵니다. --unset은 동기화를 중단하지만 모든 곳에 로컬 복사본을 유지하며, --purge는 모든 곳에서 이를 제거합니다.
기존과 동일한 개인정보 보호 모델을 따릅니다 (사용자 본인의 프라이빗 저장소(private repo)를 사용하며, 도구에는 데이터가 전혀 남지 않습니다). 저장소(Repo)는 v0.3.0 버전으로 태그되었습니다.
https://github.com/ChrisOr-Dev/claude-autosync
제출자: /u/ChrisOr-HK
[link] [comments]