CLAUDE.md와 memory

기본 패턴

/init
  -> CLAUDE.md 생성

/memory
  -> memory 파일 수정

설명

• Claude Code의 memory는 세션이 바뀌어도 계속 유지하고 싶은 규칙과 맥락을 담는 장치입니다. 대표 형태가 CLAUDE.md이고, 프로젝트 스타일, 실행 절차, 검증 규칙, 도메인 용어 같은 내용을 담기에 좋습니다.
• 공식 memory 문서는 memory에 "코드 스타일 선호", "명명 규칙", "프로젝트별 작업 방식"처럼 반복되는 기준을 넣으라고 안내합니다. 즉 이번 요청에만 필요한 정보보다, 계속 반복해서 적용할 기준이 잘 맞습니다.
• /init은 프로젝트에 CLAUDE.md를 처음 세팅할 때 유용하고, /memory는 기존 memory를 수정하거나 보강할 때 자연스럽습니다. 이 둘을 알면 세션마다 같은 설명을 다시 반복하는 비용이 크게 줄어듭니다.
• 좋은 CLAUDE.md는 길이보다 실용성이 중요합니다. 자주 깨지는 테스트 실행 순서, 필수 린트 명령, 금지 패턴, 리뷰 기준처럼 실제로 다시 찾게 되는 규칙을 넣는 편이 효과적입니다.
• 반대로 일회성 작업 지시나 현재 브랜치의 임시 상황까지 memory에 넣으면 곧 stale해집니다. memory는 "계속 유지할 규칙"에 집중하고, 현재 작업 범위는 프롬프트에서 주는 편이 맞습니다.

빠른 정리

주의할 점