---
name: Claude 메모리 저장 위치 (프로젝트 내부)
description: qcast-api의 Claude 자동 메모리 파일이 저장되는 실제 위치와 다른 PC에서 셋업하는 방법
type: 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
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에서 즉시 동일한 인덱스 사용 가능