Claude Memory 관리

Claude Memory 관리

다양한 메모리 위치와 모범 사례를 통해 세션 전반에 걸쳐 Claude Code의 메모리를 관리하는 방법을 알아보세요.
Claude Code는 워크플로의 스타일 가이드라인과 일반적인 명령 등 세션 전반의 기본 설정을 기억할 수 있습니다.

memory type 확인

클로드 코드는 세 개의 메모리 위치를 제공하며, 각각 다른 목적을 갖습니다.

Memory Type	Location	Purpose	Use Case Examples
Project memory	./CLAUDE.md	프로젝트에 대한 팀 공유 지침	프로젝트 아키텍처, 코딩 표준, 공통 워크플로
User memory	~/.claude/CLAUDE.md	모든 프로젝트에 대한 개인적 선호도	코드 스타일 기본 설정, 개인 도구 단축키
Project memory (local)	./CLAUDE.local.md	개인 프로젝트별 선호도	(더 이상 사용되지 않음, 아래 참조) 샌드박스 URL, 선호하는 테스트 데이터

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

CLAUDE.md imports

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

프로젝트 개요는 @README에서 확인하고, 이 프로젝트에 사용 가능한 npm 명령은 @package.json에서 확인하세요.

# Additional Instructions
- git workflow @docs/git-instructions.md

상대 경로와 절대 경로 모두 허용됩니다. 특히, 사용자 홈 디렉터리에 파일을 가져오면 팀원들이 저장소에 체크인되지 않은 개별 지침을 제공할 수 있는 편리한 방법입니다. 이전에는 CLAUDE.local.md가 비슷한 용도로 사용되었지만, 여러 git 작업 트리에서 더 잘 작동하기 때문에 이제는 import를 사용하는 것이 더 이상 사용되지 않습니다.

# 개인 선호
- @~/.claude/my-project-instructions.md

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

This code span will not be treated as an import: `@anthropic-ai/claude-code`

가져온 파일은 최대 5hops의 깊이로 추가 파일을 재귀적으로 가져올 수 있습니다. /memory 명령을 실행하면 로드된 메모리 파일을 확인할 수 있습니다.

Claude가 Memory을 찾는 방법

Claude Code는 재귀적으로 메모리를 읽습니다. cwd에서 시작하여 Claude Code는 루트 디렉토리까지 재귀적으로 이동합니다(루트 디렉토리는 포함하지 않음).
Claude는 현재 작업 디렉터리의 하위 트리에 중첩된 CLAUDE.md도 발견합니다. 실행 시 로드하는 대신, Claude가 해당 하위 트리의 파일을 읽을 때만 포함됩니다.

# 단축키로 memory을 빠르게 추가

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

# Always use descriptive variable names

어떤 메모리 파일에 저장할지 선택하라는 메시지가 표시됩니다.

/memory로 메모리를 직접 편집

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

프로젝트 memory 설정

중요한 프로젝트 정보, 규칙, 자주 사용되는 명령을 저장하기 위해 CLAUDE.md 파일을 설정하려고 한다고 가정해 보겠습니다.

다음 명령을 사용하여 코드베이스에 대한 CLAUDE.md를 부트스트랩합니다.

> /init 

Tips:

• Include frequently used commands (build, test, lint) to avoid repeated searches
• Document code style preferences and naming conventions
• Add important architectural patterns specific to your project
• CLAUDE.md memories can be used for both instructions shared with your team and for your individual preferences.
  

memory 모범 사례

• 구체적: "2칸 들여쓰기를 사용하세요"는 "코드를 올바르게 포맷하세요"보다 낫습니다.
• 구조를 사용하여 구성: 개별 기억을 요점별로 정리하고, 관련된 기억은 설명적인 마크다운 제목으로 그룹화합니다.
• 주기적으로 검토: 클로드가 항상 최신 정보와 맥락을 사용할 수 있도록 프로젝트가 진행됨에 따라 메모리를 업데이트하세요.