Claude Code의 각 세션은 매번 빈 컨텍스트로 시작합니다.
세션 간 지식을 이어주는 장치가 두 가지 있습니다.
CLAUDE.md | Auto Memory (MEMORY.md) | |
작성 주체 | 사용자 | Claude |
내용 | 지시·규칙 | 학습한 내용·패턴 |
범위 | 프로젝트 / 사용자 / 조직 | 저장소 단위 |
로드 시점 | 세션 시작 시 | 세션 시작 시 |
용도 | 코딩 표준, 워크플로, 프로젝트 아키텍처 | 사용자 선호, 교정 사항, 코드로 알기 어려운 맥락 |
CLAUDE.md
•
팀 전체가 따라야 하는 코딩 컨벤션, 아키텍처 패턴, 보안 관련 코딩 규칙을 작성한다.
•
팀이 주도적으로 관리하는 규칙·지침 파일이다.
•
프로젝트 루트, 상위/하위 디렉토리, 사용자 홈 (~/.claude/CLAUDE.md) 등 여러 위치에 계층적으로 둘 수 있으며, 가까운 디렉토리의 내용이 우선 적용된다.
1. CLAUDE.md 위치와 우선순위
범위 | 경로 | 용도 | 공유 대상 |
관리 정책 | macOS /Library/Application Support/ClaudeCode/CLAUDE.md
Linux/WSL /etc/claude-code/CLAUDE.md
Windows C:\Program Files\ClaudeCode\CLAUDE.md | 조직 전체 정책 (IT/DevOps가 배포) | 조직의 모든 사용자 |
사용자 지시 | ~/.claude/CLAUDE.md | 모든 프로젝트에 적용되는 개인 설정 | 나만 (모든 프로젝트) |
프로젝트 지시 | ./CLAUDE.md 또는 ./.claude/CLAUDE.md | 팀 공유 지시 (버전관리로 공유) | 팀원 |
로컬 지시 | ./CLAUDE.local.md | 개인 프로젝트별 설정 (.gitignore 권장) | 나만 (해당 프로젝트) |
2. @path import 문법
See @README for project overview and @package.json for available npm commands.
# Additional Instructions
- git workflow @docs/git-instructions.md
Shell
복사
•
상대 경로는 CLAUDE.md 파일 기준(작업 디렉토리 기준 아님)으로 해석된다.
•
재귀 import가 가능하며, 최대 깊이 4단계(hop)까지 허용된다.
•
백틱으로 감싸면(`@README`) import되지 않고 문자 그대로 표시된다.
•
작업 디렉토리 바깥을 가리키는 것은 최초 1회 승인 다이얼로그가 뜬다.
Auto Memory
•
Claude Code가 작업 중 유용한 컨텍스트를 자동으로 기록하고, 이후 세션에서 다시 불러오는 자동 메모리 기능이다.
•
작업 흐름에서 발견한 프로젝트 패턴, 주요 명령어, 개인 선호도를 사용자 로컬 환경에서 프로젝트별로 MEMORY.md에 자동 저장한다. (다음 세션 시작 시 이를 불러와 컨텍스트에 반영한다.)
•
Auto Memory는 Claude Code 설치 시 기본으로 활성화 되어 있다.
•
MEMORY.md는 첫 200줄만 자동 로딩 되며, 상세 내용은 토픽 파일로 분리하도록 설계되어 있다.
•
그럼으로 /memory명령어로, 주기적으로 중요하지 않은 패턴을 주기적으로 정리하는 것을 권장한다.