Claude Code는 스타일 가이드라인과 워크플로우의 일반적인 명령어와 같은 사용자의 선호사항을 세션 간에 기억할 수 있습니다.

​
메모리 유형 결정

Claude Code는 각각 다른 목적을 가진 세 가지 메모리 위치를 제공합니다:

메모리 유형위치목적사용 사례 예시
프로젝트 메모리./CLAUDE.md프로젝트를 위한 팀 공유 지침프로젝트 아키텍처, 코딩 표준, 일반적인 워크플로우
사용자 메모리~/.claude/CLAUDE.md모든 프로젝트에 대한 개인 선호사항코드 스타일링 선호사항, 개인 도구 단축키
프로젝트 메모리 (로컬)./CLAUDE.local.md개인 프로젝트별 선호사항(아래 참조, 더 이상 사용되지 않음) 샌드박스 URL, 선호하는 테스트 데이터

모든 메모리 파일은 Claude Code가 실행될 때 자동으로 컨텍스트에 로드됩니다.

​
CLAUDE.md 가져오기

CLAUDE.md 파일은 @path/to/import 구문을 사용하여 추가 파일을 가져올 수 있습니다. 다음 예시는 3개의 파일을 가져옵니다:

프로젝트 개요는 @README를 참조하고 이 프로젝트에서 사용 가능한 npm 명령어는 @package.json을 참조하세요.

# 추가 지침
- git 워크플로우 @docs/git-instructions.md

상대 경로와 절대 경로 모두 허용됩니다. 특히, 사용자의 홈 디렉토리에 있는 파일을 가져오는 것은 팀 멤버들이 저장소에 체크인되지 않은 개별 지침을 제공하는 편리한 방법입니다. 이전에는 CLAUDE.local.md가 비슷한 목적을 수행했지만, 여러 git worktree에서 더 잘 작동하는 가져오기 기능을 위해 현재는 더 이상 사용되지 않습니다.

# 개별 선호사항
- @~/.claude/my-project-instructions.md

잠재적인 충돌을 피하기 위해, 가져오기는 마크다운 코드 스팬과 코드 블록 내에서는 평가되지 않습니다.

이 코드 스팬은 가져오기로 처리되지 않습니다: `@anthropic-ai/claude-code`

가져온 파일은 재귀적으로 추가 파일을 가져올 수 있으며, 최대 깊이는 5홉입니다. /memory 명령어를 실행하여 어떤 메모리 파일이 로드되었는지 확인할 수 있습니다.

​
Claude가 메모리를 찾는 방법

Claude Code는 메모리를 재귀적으로 읽습니다: cwd에서 시작하여, Claude Code는 / 까지 재귀적으로 올라가며 찾은 모든 CLAUDE.md 또는 CLAUDE.local.md 파일을 읽습니다. 이는 foo/bar/ 에서 Claude Code를 실행하고 foo/CLAUDE.md 와 foo/bar/CLAUDE.md 모두에 메모리가 있는 대규모 저장소에서 작업할 때 특히 편리합니다.

Claude는 또한 현재 작업 디렉토리 하위의 서브트리에 중첩된 CLAUDE.md를 발견합니다. 실행 시 로드하는 대신, 해당 서브트리의 파일을 Claude가 읽을 때만 포함됩니다.

​
# 단축키로 빠르게 메모리 추가

메모리를 추가하는 가장 빠른 방법은 입력을 # 문자로 시작하는 것입니다:

# 항상 설명적인 변수명을 사용하세요

이를 저장할 메모리 파일을 선택하라는 메시지가 표시됩니다.

​
/memory로 메모리 직접 편집

세션 중에 /memory 슬래시 명령어를 사용하여 시스템 편집기에서 메모리 파일을 열어 더 광범위한 추가나 정리를 할 수 있습니다.

​
프로젝트 메모리 설정

중요한 프로젝트 정보, 규칙, 자주 사용하는 명령어를 저장하기 위해 CLAUDE.md 파일을 설정하고 싶다고 가정해봅시다.

다음 명령어로 코드베이스용 CLAUDE.md를 부트스트랩하세요:

> /init

팁:

  • 반복적인 검색을 피하기 위해 자주 사용하는 명령어(빌드, 테스트, 린트)를 포함하세요
  • 코드 스타일 선호사항과 명명 규칙을 문서화하세요
  • 프로젝트에 특정한 중요한 아키텍처 패턴을 추가하세요
  • CLAUDE.md 메모리는 팀과 공유하는 지침과 개인 선호사항 모두에 사용할 수 있습니다.

​
메모리 모범 사례

  • 구체적으로 작성하세요: “2칸 들여쓰기 사용”이 “코드를 적절히 포맷”보다 좋습니다.
  • 구조를 사용하여 정리하세요: 각 개별 메모리를 글머리 기호로 포맷하고 관련 메모리를 설명적인 마크다운 제목 아래 그룹화하세요.
  • 주기적으로 검토하세요: Claude가 항상 최신 정보와 컨텍스트를 사용하도록 프로젝트가 발전함에 따라 메모리를 업데이트하세요.