CLAUDE.md 작성법이 "무엇을 어떻게 쓰나"라면, 이 글은 프로젝트 유형별로 바로 복붙해 시작할 수 있는 완성 예시 모음입니다. 그대로 두지 말고 반드시 자기 프로젝트에 맞게 고쳐 쓰세요. (공식 메모리 문서: docs.claude.com · 기준 시점: 2026년 6월)
예시를 쓰기 전에
- 고유한 것만 — "깨끗한 코드를 써라" 같은 일반 지침 대신, 이 프로젝트에만 해당하는 규칙을 담으세요.
- 간결하게 — 길수록 컨텍스트를 많이 먹고 준수도가 떨어질 수 있습니다(공식 문서는 지나치게 긴 파일을 경계합니다).
- 실제 값으로 교체 — 아래 예시의
<...>부분은 모두 자리표시자입니다.
웹 앱 프로젝트
# 프로젝트: <이름>
## 개요
- 스택: <예: Next.js, TypeScript, Tailwind>
- 구조: <주요 디렉토리 설명>
## 규칙
- 컴포넌트는 <규칙: 예) 함수형 + 명시적 props 타입>
- 상태 관리는 <예: 서버 컴포넌트 우선, 전역 상태 최소화>
## 명령
- 개발: <실제 개발 서버 명령>
- 빌드/테스트: <실제 명령>
## 주의
- 비밀 키는 환경변수로만, 코드/커밋에 넣지 않기
- <프로젝트 특유의 함정>데이터 · ML 프로젝트
# 프로젝트: <이름>
## 개요
- 목적: <무엇을 분석/학습하는가>
- 데이터 위치: <경로 또는 저장소>
## 규칙
- 재현성: 시드 고정, 환경/버전 명시
- 실험 기록: <어디에 어떻게 남기는가>
- 대용량/민감 데이터는 커밋 금지
## 명령
- 환경 준비: <실제 명령>
- 학습/평가: <실제 명령>문서 · 콘텐츠 프로젝트
# 프로젝트: <이름>
## 문체
- 톤: <예: 친근한 존댓말>
- 길이/형식: <예: 문단 2~3문장, 불릿 최소화>
## 용어
- 항상 쓰는 표기: <예: "사용자" (O) / "유저" (X)>
- 금지 표현: <예: 과장·단정 표현>
## 절차
- 발행 전 점검: <체크리스트>모노레포: 루트 + 하위
모노레포에서는 공통 규칙을 루트에, 컴포넌트별 세부 규칙을 하위 폴더에 둡니다. 공식 문서에 따르면 Claude Code는 시작할 때 현재 위치에서 위로 올라가며 만나는 CLAUDE.md(조상)를 모두 로드하고, 하위 폴더의 CLAUDE.md는 그 폴더 파일을 다룰 때 로드(lazy)되며, 작업과 무관한 형제 폴더의 것은 로드되지 않습니다.
monorepo/
├── CLAUDE.md # 공통(코딩 표준, 커밋 규칙) — 항상 로드
├── frontend/
│ └── CLAUDE.md # 프론트 전용 — frontend 작업 시 로드
└── backend/
└── CLAUDE.md # 백엔드 전용 — backend 작업 시 로드더 다듬기
중복을 피하려면 기존 문서를 @경로로 가져올 수 있습니다(예: @README.md). 가져온 파일도 시작 시 함께 로드되니, 정말 매 세션에 필요한 것만 두세요. 위치 계층(프로젝트 ./CLAUDE.md, 사용자 ~/.claude/CLAUDE.md 등)과 작동 원리는 작성법과 CLAUDE.md 완전 가이드에서 자세히 다룹니다.
관련 가이드
Claude Code 자체가 처음이라면 Claude Code란과 사용법을 함께 보세요.
위 예시는 출발점일 뿐이며, 반드시 자기 프로젝트에 맞게 수정해야 합니다. 로딩 동작·위치·문법 등 세부 사항은 변동될 수 있으니 공식 문서(docs.claude.com)를 기준으로 확인하시기 바랍니다. 본 사이트는 Anthropic 공식 사이트가 아닙니다.