Claude Code 완전 가이드 · 3 min read
Memory & Rules
CLAUDE.md, Auto Memory, Rules — 세 가지 영구 컨텍스트 시스템을 이해합니다.
Auto Memory (Claude가 자동 기록)
Claude Code는 세션 중 학습한 내용을 자동으로 ~/.claude/projects/<project>/memory/MEMORY.md에 기록합니다.
- MEMORY.md의 처음 200줄이 매 세션 로드됨
- 토픽별 파일은 필요 시에만 로드 (on-demand)
- 같은 git repo의 모든 worktree가 하나의 메모리 디렉토리를 공유
/memory명령으로 직접 확인/편집 가능
서브에이전트 메모리 스코프
| 스코프 | 위치 | 용도 |
|---|---|---|
user | ~/.claude/agent-memory/ | 모든 프로젝트에서 공유되는 개인 메모리 |
project | .claude/agent-memory/ | 프로젝트 팀 공유 메모리 (git 커밋) |
local | .claude/agent-memory-local/ | 프로젝트 개인 메모리 (git-ignored) |
Rules 시스템 (.claude/rules/)
CLAUDE.md를 200줄 이내로 유지하면서 세부 규칙을 관리하는 방법입니다. glob 패턴으로 특정 파일을 다룰 때만 로드됩니다.
# .claude/rules/testing.md
# Glob: **/*.test.ts
## 테스트 규칙
- vitest를 사용하되, jest 문법은 피한다
- mock 대신 실제 DB를 사용한다
- 각 테스트는 독립적으로 실행 가능해야 한다조직 관리형 CLAUDE.md (Managed Policy)
조직이 강제하는 CLAUDE.md로, 개별 사용자가 오버라이드할 수 없습니다:
| OS | 경로 |
|---|---|
| macOS | /Library/Application Support/ClaudeCode/CLAUDE.md |
| Linux/WSL | /etc/claude-code/CLAUDE.md |
| Windows | C:\Program Files\ClaudeCode\CLAUDE.md |
INFO:
/compact실행 후에도 CLAUDE.md는 디스크에서 다시 읽어 생존합니다. 하지만 대화 컨텍스트의 세부 사항은 손실될 수 있으므로, 중요한 결정 사항은 반드시 파일로 기록하세요. 모노레포에서 다른 팀의 CLAUDE.md가 불필요하면claudeMdExcludes설정으로 제외할 수 있습니다.