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

​
메모리 유형 결정

Claude Code는 계층 구조로 된 네 가지 메모리 위치를 제공하며, 각각 다른 목적을 가지고 있습니다:
메모리 유형위치목적사용 사례 예시공유 대상
엔터프라이즈 정책macOS: /Library/Application Support/ClaudeCode/CLAUDE.md
Linux: /etc/claude-code/CLAUDE.md
Windows: C:\ProgramData\ClaudeCode\CLAUDE.md		IT/DevOps에서 관리하는 조직 전체 지침회사 코딩 표준, 보안 정책, 규정 준수 요구사항조직의 모든 사용자
프로젝트 메모리./CLAUDE.md 또는 ./.claude/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 또는 ./.claude/CLAUDE.md에 저장할 수 있습니다. 다음 명령어로 코드베이스용 CLAUDE.md를 부트스트랩하세요: 
> /init
팁:
  • 반복적인 검색을 피하기 위해 자주 사용하는 명령어(빌드, 테스트, 린트)를 포함하세요
  • 코드 스타일 기본 설정과 명명 규칙을 문서화하세요
  • 프로젝트에 특정한 중요한 아키텍처 패턴을 추가하세요
  • CLAUDE.md 메모리는 팀과 공유하는 지침과 개인 기본 설정 모두에 사용할 수 있습니다.

​
조직 수준 메모리 관리

엔터프라이즈 조직은 모든 사용자에게 적용되는 중앙 관리형 CLAUDE.md 파일을 배포할 수 있습니다. 조직 수준 메모리 관리를 설정하려면:
  1. 운영 체제에 적합한 위치에 엔터프라이즈 메모리 파일을 생성하세요:
  • macOS: /Library/Application Support/ClaudeCode/CLAUDE.md
  • Linux/WSL: /etc/claude-code/CLAUDE.md
  • Windows: C:\ProgramData\ClaudeCode\CLAUDE.md
  1. 모든 개발자 머신에 일관된 배포를 보장하기 위해 구성 관리 시스템(MDM, 그룹 정책, Ansible 등)을 통해 배포하세요.

​
메모리 모범 사례

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