qcast-api/.claude/memory/reference_memory_location.md

name	description	type
Claude 메모리 저장 위치 (프로젝트 내부)	qcast-api의 Claude 자동 메모리 파일이 저장되는 실제 위치와 다른 PC에서 셋업하는 방법	reference

2026-05-06부터 qcast-api의 Claude 자동 메모리는 프로젝트 내부에 저장하고 git으로 관리한다.

구조

• 실제 저장 위치: <repo>/.claude/memory/ (git 추적 대상)
• Claude Code가 접근하는 경로: ~/.claude/projects/-Users-cha-Works-Projects-qcast3-qcast-api/memory/
  • 위 경로는 <repo>/.claude/memory/ 로 향하는 symlink
• commit_log.txt 만 예외적으로 머신 로컬 (gitignore 처리됨)

다른 PC에서 처음 셋업할 때

저장소 클론 직후 한 번만 실행:

sh .claude/setup-memory-symlink.sh

스크립트는 멱등성이 보장되며, Claude Code 인코딩 규칙(working dir 절대경로의 /를 -로 치환)에 맞춰 ~/.claude/projects/<encoded>/memory symlink를 자동 생성한다. 클론 위치가 다르면 인코딩도 자동으로 달라진다.

활용

• 메모리 파일을 추가/수정하면 git diff에 잡히므로 다른 변경과 함께 커밋 가능
• 새 메모리 작성 시에도 기존 자동 메모리 흐름 그대로 (Write 후 MEMORY.md 인덱스 추가) — 어느 경로로 쓰든 symlink를 통해 같은 파일을 가리킴
• MEMORY.md도 git에 함께 커밋되어 다른 PC에서 즉시 동일한 인덱스 사용 가능