[Claude Code 스킬] CLAUDE.md — 프로젝트 규칙을 매번 다시 설명하지 않기 | DAKER 커뮤니티
무엇 : CLAUDE.md는 Claude Code가 세션을 시작할 때 읽는 프로젝트 지침 파일입니다. 빌드 명령, 코딩 규칙, 검증 기준처럼 매번 반복해서 말해야 하는 사실을 한곳에 둡니다. 자동 메모리는 Claude가 작업 중 발견한 패턴을 저장하는 보조 장치이고, 둘 다 강제 정책이 아니라 컨텍스트로 작동합니다.
언제 쓰나 : 같은 수정 요청을 두 번 이상 반복했을 때, 새 팀원이 알아야 할 프로젝트 구조가 있을 때, 또는 코드 리뷰에서 “Claude가 이미 알았어야 할 규칙”이 드러났을 때 씁니다. 파일 종류별 세부 규칙은 별도 규칙 파일로 나누고, 위험 명령 차단처럼 반드시 막아야 하는 행동은 hook으로 분리하는 편이 안전합니다.
사용법 : 프로젝트 루트에 짧은 규칙을 먼저 두고, 세션 안에서 로드된 기억을 확인합니다.
# 프로젝트 루트에 팀 규칙 작성
cat > CLAUDE.md <<'EOF'
# Project instructions
- Use pnpm for package scripts.
- Run pnpm test before reporting a feature as complete.
- Do not change database migrations without explicit review.
EOF
# 현재 세션에서 로드된 메모리와 규칙 확인
claude
/memory
팁 : 첫째, CLAUDE.md는 200줄 안팎의 짧은 원칙 파일로 유지하세요. 길고 절차적인 내용은 skill이나 별도 문서로 빼야 모델이 매번 핵심을 덜 놓칩니다. 둘째, “항상 테스트 실행”처럼 기대 행동은 CLAUDE.md에 쓰되, “삭제 금지”처럼 실패하면 큰 행동은 PreToolUse hook 같은 실행 전 차단 장치로 보강하세요.
출처 : 기능 사실은 Anthropic Claude Code 공식 문서의 memory, extension overview, CLI reference 항목으로 확인했습니다. 공개 본문에는 DAKER 운영 정책에 따라 아래 내부 링크만 남깁니다.