<aside> 📌
이 페이지는 **CLAUDE.md 작성법** 영상의 핵심 정리 치트시트입니다. CLAUDE.md를 "README"가 아니라 "Claude가 같은 실수를 안 하게 하는 가드레일"이라는 관점에서 다시 설계합니다. 작동 원리, 크기 관리, 작성 팁, 공식 플러그인까지 한 페이지에 담았습니다.
</aside>
<aside> 💡
오늘의 한 줄 정의 "인간이 읽는 README가 아니라, Claude가 같은 실수를 안 하게 하는 instructions"
이 한 줄만 받아들이면 CLAUDE.md를 쓰는 방식이 바뀝니다. 더 짧아지고, 더 정확해지고, 결과 품질이 올라갑니다.
</aside>
CLAUDE.md는 한 군데에 있는 파일이 아닙니다. Claude Code는 매 메시지마다 아래 4가지 위치에서 자동으로 읽어와 합쳐서 전달합니다. 직접 import하거나 호출할 필요가 없습니다.
| 위치 | 용도 | 비유 |
|---|---|---|
~/.claude/CLAUDE.md |
전역 — 모든 프로젝트 공통 | 내 개인 노트 |
<repo>/.claude/CLAUDE.md |
팀 공유 — 소스컨트롤에 체크인 | 회사 가이드 |
<repo>/CLAUDE.local.md |
개인 per-repo — .gitignore에 추가 |
책상 위 메모 |
<subdir>/CLAUDE.md |
서브디렉토리 — 특정 폴더만 적용 | 부서별 규칙 |
<aside> 💡
어디에 둘지 결정하는 한 줄 규칙 • 범용적이면 → 위쪽 (전역/팀 공유) • 특수하면 → 아래쪽 (CLAUDE.local.md, 서브디렉토리)
예: 내 코딩 스타일·커뮤니케이션 선호도 → 전역 / 빌드·테스트 명령어 → 팀 공유 / 개인 단축어·임시 토큰 → CLAUDE.local.md / 모노레포 패키지별 규칙 → 서브디렉토리.
</aside>