[Claude Code] 메모리 관리 - CLAUDE.md

참고) 공식문서: https://code.claude.com/docs/ko/memory

클로드는 세션을 종료하고 다시 시작하면 이전 대화내용을 다 까먹는다.
세션을 다시 시작해도 기억해야되는 내용들은 CLAUDE.md 파일에 정리하자!

경로 별 역할

어느 경로에 있는지에 따라 역할이 달라진다. (공식문서 링크)

1. 프로젝트 메모리

• ./CLAUDE.md 혹은 ./.claude/CLAUDE.md
• 이 프로젝트에서만 적용할 지침
• 팀원들에게 공유하는 용도!

2.프로젝트 메모리 (로컬)

• ./CLAUDE.local.md
• 개인용. 나만의 규칙!
• 자동으로 .gitignore에 추가된다. (자동으로 추가되지 않으면 직접 추가하자)

3. 사용자 메모리

• ~/.claude/CLAUDE.md (해당 경로에 파일이 없을 수도 있다. 그러면 직접 만들자)
• 내 PC에 있는 모든 프로젝트에 대한 개인 지침
• 모든 프로젝트에 적용해야 할 규칙

CLAUDE.md에서 다른 파일 import 하기

CLAUDE.md 파일은 500줄 이하로 작성되는 것을 권장한다. (공식문서 링크)
따라서 길어질 것 같으면 별도 파일에 작성하고 import 해오자!

@path/to/import 구문을 사용하여 추가 파일을 가져올 수 있다.
가져온 파일은 확장되어 참조하는 CLAUDE.md와 함께 시작 시 컨텍스트에 로드된다.

일반적으로 프로젝트 설명은 README.md 파일에 기재되어있으므로, 해당 파일을 CLAUDE.md에게 전달한다.

프로젝트 개요는 @README를 참조하고 이 프로젝트의 사용 가능한 npm 명령은 @package.json을 참조합니다.

# 추가 지침
- git workflow @docs/git-instructions.md

모범사례

1. 구체적으로 작성 : "2칸 들여쓰기 사용"이 "코드를 적절히 포맷합니다" 보다 낫다!
2. 구조를 사용하여 구성 : 헤더로 영역 분리, 헤더 아래에 각 설명 그룹화 하자!
3. 정기적으로 업데이트 : 프로젝트 진행에 따라 CLAUDE.md 업데이트하여 항상 최신 정보와 컨텍스트 유지할 수 있도록 하자!
4. 지침에 추가했으나 클로드가 따르지 않는 경우, [중요]와 같이 강조해서 기재하자

/memory 명령어

현재 세션에 로드된 메모리 목록 확인 및 로드된 메모리 바로 편집 가능하게 하는 명령어.
(메모리: CLAUDE.md)