클로드 코드를 쓰면서 같은 프로젝트 맥락을 자꾸 다시 설명하게 된다면, 단순히 대화가 길어져서가 아니라 메모리 구조를 제대로 안 쓰고 있을 가능성이 있습니다. 이럴 때 확인할 수 있는 명령이 /memory입니다.
이 글은 클로드 코드 /memory 사용법을 중심으로, 어떤 메모리 파일이 있는지, 프로젝트 메모리와 사용자 메모리를 어떻게 나눠야 하는지, 왜 반복 설명이 줄어드는지 정리했습니다.
Table of Contents
/memory는 언제 필요한가
공식 slash commands 문서에는 /memory가 메모리 파일을 편집하는 명령으로 나옵니다. 또한 공식 메모리 문서에서는 어떤 CLAUDE.md 파일이 계층적으로 적용되는지 설명합니다.
- 프로젝트 규칙이 자꾸 누락되는 느낌이 들 때
- 개인 취향과 팀 규칙이 섞여 헷갈릴 때
- 어떤 메모리가 실제로 적용되는지 확인하고 싶을 때
공식 문서 기준 메모리 위치
./CLAUDE.md: 프로젝트 메모리~/.claude/CLAUDE.md: 사용자 메모리- 조직 단위 정책 메모리 : 운영체제별 고정 경로
이 구조를 이해하면 왜 어떤 규칙은 모든 프로젝트에서 반복 적용되고, 어떤 규칙은 특정 저장소에서만 적용되는지 감이 잡힙니다.
반복 설명이 줄어드는 이유
메모리를 제대로 정리하면 매번 “이 프로젝트는 이런 구조예요”, “테스트는 이 순서로 돌려요” 같은 설명을 다시 하지 않아도 됩니다. 결국 프롬프트를 짧게 유지하면서도 일관성을 챙기기 쉬워집니다.
처음에는 크게 만들지 않는 편이 낫다
처음부터 메모리 파일에 너무 많은 규칙을 넣으면 오히려 관리가 어려워집니다. 진짜 자주 반복되는 기준만 먼저 넣고, 필요한 것만 추가하는 흐름이 더 현실적입니다.
정리
/memory는 메모리 구조를 관리하는 입구로 생각하면 쉽습니다. 프로젝트 메모리와 사용자 메모리의 역할만 구분해도 반복 설명이 줄고, 작업 흐름이 훨씬 안정적입니다.
참고한 공식 문서
- Anthropic Slash commands
- Anthropic Manage Claude’s memory
