Claude Code의 지식과 설정을 동기화하는 claude-sync 도구 공개

실용적 조언

npx skills add SamTerces/claude-sync 명령어로 즉시 설치하여 사용할 수 있다.
팀 프로젝트 시작 시 공통의 CLAUDE.md를 claude-sync로 공유하여 에이전트의 응답 일관성을 높일 수 있다.
민감한 정보가 포함될 수 있으므로 자동 push 기능을 사용할 때는 필터링 설정을 먼저 확인해야 한다.

섹션별 상세

claude-sync는 Claude Code의 메모리, 스킬, 에이전트 설정 및 CLAUDE.md 파일을 Git 리포지토리에 동기화한다. 사용자가 push 명령을 내리면 로컬의 에이전트 컨텍스트가 원격 저장소로 전송되며, pull을 통해 다른 환경에서 이를 그대로 불러올 수 있다. 이를 통해 개발자는 새로운 기기에서도 에이전트를 처음부터 다시 교육할 필요 없이 기존의 아키텍처 지식을 즉시 활용한다. 팀 단위에서는 공통된 코딩 컨벤션을 에이전트에게 일괄 적용하는 것이 가능해졌다.

bash

claude-sync push # share your brain
claude-sync pull # absorb team context
claude-sync merge alice # inherit a teammate's learnings

claude-sync의 기본적인 CLI 명령어 사용 예시

text

/sync push, /sync pull, /sync merge alice

Claude Code 내부에서 직접 실행 가능한 슬래시 명령어

보안과 충돌 관리를 위해 데이터 전송 전 비밀 정보 제거(Secret Scrubbing)와 차분 비교(Diff) 기능을 수행한다. push 명령 실행 시 API 키 등 민감한 정보를 자동으로 필터링하여 Git 저장소에 노출되는 것을 방지한다. 또한 merge 명령을 통해 팀원의 학습 내용을 가져올 때는 기존 설정을 덮어쓰지 않고 변경 사항을 비교하여 보여준다. Watch 모드를 활성화하면 메모리에 쓰기 작업이 발생할 때마다 자동으로 push를 수행하여 실시간 동기화를 유지한다.

bash

npx skills add SamTerces/claude-sync

claude-sync 도구를 설치하고 추가하는 명령어

현재 v1.0.0 버전으로 공개되었으며 향후 다양한 백엔드와 멀티 에이전트 지원을 계획하고 있다. 로드맵에는 데이터 암호화, S3 백엔드 지원, 선택적 동기화 기능이 포함되어 있다. 또한 Cursor, Codex, Gemini CLI 등 다른 AI 코딩 도구와의 통합도 준비 중이다. 현재 GitHub를 통해 오픈소스로 기여자를 모집하고 있으며 기술적 피드백을 수용하고 있다.

용어 해설

CLAUDE.md: — Claude Code가 프로젝트의 컨텍스트, 아키텍처 결정 사항, 코딩 규칙 등을 저장하는 설정 파일이다. 에이전트가 코드베이스를 이해하고 일관된 스타일을 유지하는 데 핵심적인 역할을 한다.
메모리 동기화(Memory Sync): — AI 에이전트가 학습한 지식이나 컨텍스트를 여러 환경 간에 공유하는 기술이다. 개발자가 설정한 규칙이나 에이전트의 경험을 다른 기기나 팀원에게 전달하여 중복 학습을 방지한다.
비밀 정보 제거(Secret Scrubbing): — 데이터를 외부 저장소에 업로드하기 전 API 키나 비밀번호 같은 민감한 정보를 자동으로 감지하고 삭제하는 보안 프로세스이다. 공유 환경에서 보안 사고를 예방하는 필수적인 단계이다.

언급된 도구

claude-sync추천링크

Claude Code의 메모리 및 설정 동기화

Claude Code중립

Anthropic의 CLI 기반 AI 코딩 에이전트

언급된 리소스

GitHubclaude-sync GitHub Repository

문서skills.sh claude-sync Page