당신은 ~/.claude Config를 버전 관리해야 합니다

Source: Dev.to

버전 관리 대상

공식 문서에 따르면, 다음 파일 및 디렉터리를 버전 관리하는 것이 좋습니다:

• CLAUDE.md
• settings.json
• skills/**/SKILL.md
• agents/.md
• commands/.md
• statusline.sh

.gitignore

Claude Code는 무시해야 할 일시적인 데이터를 생성합니다. 다음 패턴을 .gitignore에 추가하세요:

# Credentials
.credentials.json
credentials.json

# Internal state
.claude.json
.claude.json.backup.*
security_warnings_*.json
stats-cache.json
mcp-needs-auth-cache.json

# Session data
history.jsonl
backups
cache
debug
file-history
paste-cache
session-env
shell-snapshots

# Agent and team state
plans
plugins
tasks
teams
todos

# Telemetry
statsig
telemetry
usage-data

# IDE integration
ide/

Projects 디렉터리

projects/ 디렉터리에는 프로젝트별 자동 메모리와 대화 로그가 들어 있습니다. Claude Code가 이제 프로젝트별 메모리를 지원하므로, 디렉터리는 버전 관리에 포함하되 큰 로그 파일은 무시하는 것이 좋습니다:

projects/**/*.jsonl
projects/**/*.txt

저장소 초기화 및 GitHub에 푸시

cd ~/.claude
git init
git add .gitignore CLAUDE.md settings.json
git add skills/ agents/ commands/ statusline.sh 2>/dev/null
git commit -m "feat: initial claude config"
gh repo create claude-config --private --source=. --push

이렇게 하면 Claude 설정이 이제 버전 관리되고 원격 저장소에 안전하게 저장됩니다.