Claude Code 멀티환경 설정 공유 가이드

문제

Claude Code의 커스텀 설정은 각 계정의 ~/.claude/ 에 저장된다. 여러 계정을 쓰면 동일한 설정을 각각 복사해야 하고, 하나를 수정하면 나머지도 직접 업데이트해야 한다.

해결: Junction Point로 실시간 공유

핵심 아이디어: 설정 파일을 공유 폴더 하나에 모으고, 각 계정에서 Junction(디렉토리) / Symlink(파일) 로 연결한다.

공유 폴더에 실체를 두고, 각 환경의 ~/.claude/ 하위 디렉토리를 Junction으로 연결하는 구조다:

어느 환경에서 수정해도 즉시 나머지에 반영된다.

공유 대상 vs 격리 대상

세팅 방법

1단계: 공유 폴더 생성 + 파일 이동

mkdir "C:\Shared\claude-config"
robocopy "%USERPROFILE%\.claude\skills" "C:\Shared\claude-config\skills" /E /MOVE
robocopy "%USERPROFILE%\.claude\agents" "C:\Shared\claude-config\agents" /E /MOVE
:: hooks, plugins도 동일하게

2단계: Junction / Symlink 생성 (반드시 CMD에서!)

:: 디렉토리 → Junction (관리자 권한 불필요)
mklink /J "%USERPROFILE%\.claude\skills" "C:\Shared\claude-config\skills"

:: 파일 → Symlink (Developer Mode 필요)
mklink "%USERPROFILE%\.claude\settings.json" "C:\Shared\claude-config\settings.json"

3단계: 다른 계정에도 동일하게 Junction 생성

4단계: WSL에서는 ln -s 사용

ln -sfn /mnt/c/Shared/claude-config/skills ~/.claude/skills

주의: mklink는 반드시 Windows CMD에서 실행해야 한다. Git Bash에서 실행하면 경로가 /mnt/c/... 형태로 저장되어 Windows에서 인식하지 못한다. 잘못 생성된 Junction은 fsutil reparsepoint delete 후 삭제 가능하다.

다른 방법과의 비교

왜 플러그인 마켓플레이스가 아닌가?

동일 머신 내 공유에는 Junction이 압도적으로 편리하다. 다른 머신으로 확장이 필요하면 GitHub 관리를 추가하면 된다.

chezmoi 등 dotfile 관리 도구

chezmoi, GNU stow, yadm 등도 선택지다. 다만 Claude Code 설정 공유만이 목적이라면 Junction으로 충분하고, 설정이 여러 머신에 분산될 때 chezmoi를 도입하는 게 적절하다.

향후 확장: GitHub 버전 관리

공유 폴더를 Git 저장소로 만들면 변경 이력 추적 + 롤백 + 다른 머신 배포가 가능하다.

cd /path/to/shared-config
git init
git remote add origin https://github.com/yourname/claude-config.git  # private repo

.gitignore 예시

# 민감 정보
discord-config.json
*.secret

# 런타임 생성
plugins/cache/
plugins/data/
plugins/marketplaces/
plugins/install-counts-cache.json

# 의존성
hooks/discord-bot/node_modules/

민감 정보 분리

Discord webhook URL 등은 settings.local.json (gitignore 대상)의 환경 변수로 분리:

{
  "env": {
    "DISCORD_WEBHOOK_URL": "https://discord.com/api/webhooks/..."
  }
}

다른 머신에서 복원

git clone https://github.com/yourname/claude-config.git /shared/claude-config
# 이후 각 계정에서 Junction/Symlink 연결

자동 동기화 (선택)

Claude Code의 Stop 훅으로 세션 종료 시 자동 커밋:

{
  "hooks": {
    "Stop": [{
      "hooks": [{
        "type": "command",
        "command": "cd /path/to/shared-config && git add -A && git diff --cached --quiet || git commit -m 'auto: config updated'"
      }]
    }]
  }
}

단계별 로드맵

대부분의 경우 1~2단계만으로 충분하다.

참고 자료