29 lines
1.4 KiB
Markdown
29 lines
1.4 KiB
Markdown
---
|
|
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에서 즉시 동일한 인덱스 사용 가능
|