메인 콘텐츠로 건너뛰기
Claude Code는 코드 스타일 가이드라인 및 워크플로우의 일반적인 명령어와 같은 세션 간 기본 설정을 기억할 수 있습니다.

​
메모리 유형 결정

Claude Code는 계층 구조로 구성된 4가지 메모리 위치를 제공하며, 각각 다른 목적으로 사용됩니다:
메모리 유형위치목적사용 사례 예시공유 대상
엔터프라이즈 정책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개의 파일을 가져옵니다: 
See @README for project overview and @package.json for available npm commands for this project.

# Additional Instructions
- git workflow @docs/git-instructions.md
상대 경로와 절대 경로 모두 허용됩니다. 특히 사용자의 홈 디렉토리에 있는 파일을 가져오는 것은 팀 멤버가 저장소에 체크인되지 않은 개인 지침을 제공하는 편리한 방법입니다. 이전에 CLAUDE.local.md가 유사한 목적으로 사용되었지만, 이제는 여러 git 워크트리에서 더 잘 작동하므로 가져오기를 선호하여 더 이상 사용되지 않습니다. 
# Individual Preferences
- @~/.claude/my-project-instructions.md
잠재적 충돌을 피하기 위해 가져오기는 마크다운 코드 스팬 및 코드 블록 내에서 평가되지 않습니다. 
This code span will not be treated as an import: `@anthropic-ai/claude-code`
가져온 파일은 최대 깊이 5홉까지 추가 파일을 재귀적으로 가져올 수 있습니다. /memory 명령어를 실행하여 로드된 메모리 파일을 확인할 수 있습니다.

​
Claude가 메모리를 조회하는 방법

Claude Code는 메모리를 재귀적으로 읽습니다: 현재 작업 디렉토리에서 시작하여 Claude Code는 루트 디렉토리 / 까지 (루트 디렉토리는 포함하지 않음) 재귀하고 발견한 모든 CLAUDE.md 또는 CLAUDE.local.md 파일을 읽습니다. 이는 foo/bar/ 에서 Claude Code를 실행하고 foo/CLAUDE.md 와 foo/bar/CLAUDE.md 모두에 메모리가 있는 대규모 저장소에서 작업할 때 특히 편리합니다. Claude는 또한 현재 작업 디렉토리 아래의 하위 트리에 중첩된 CLAUDE.md를 발견합니다. 시작 시 로드하는 대신 Claude가 해당 하위 트리의 파일을 읽을 때만 포함됩니다.

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

메모리를 추가하는 가장 빠른 방법은 입력을 # 문자로 시작하는 것입니다: 
# Always use descriptive variable names
이 메모리를 저장할 메모리 파일을 선택하라는 메시지가 표시됩니다.

​
/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가 항상 최신 정보와 컨텍스트를 사용하도록 합니다.