규칙 파일 — CLAUDE.md

매번 “이모지 빼고, 존댓말로” 같은 규칙을 다시 적어야 한다면, 그만큼 요청이 길어지고 깜빡 빠뜨린 요청만 규칙에서 벗어난 결과를 받게 됩니다.

CLAUDE.md는 세션이 시작될 때 자동으로 읽히는 규칙 파일입니다. 폴더 구조, 금지 사항, 톤, 자주 쓰는 명령어처럼 매번 설명하던 내용을 여기 적어 두면 이후 요청에서는 생략할 수 있습니다. 빈 프로젝트라면 /init을 실행해 코드와 문서를 분석한 초안을 먼저 받아볼 수 있습니다.

파일은 크게 두 층입니다. 프로젝트 루트의 CLAUDE.md는 그 프로젝트에서 함께 일하는 사람과 공유하는 규칙이고, 사용자 홈 폴더의 ~/.claude/CLAUDE.md는 어떤 프로젝트를 열어도 항상 적용되는 개인 규칙입니다. 같은 내용이 두 파일에 있으면 프로젝트 파일이 우선 적용됩니다. 흔한 안티패턴은 온갖 규칙을 하나의 파일에 계속 이어 붙이는 것으로, 파일이 길어질수록 실제로 지켜지는 비율이 떨어지므로 안 쓰는 규칙은 지우고 자주 어기는 규칙은 눈에 잘 띄는 자리로 옮깁니다.

아래 연습을 그대로 붙여넣어 CLAUDE.md 초안부터 만들어 보세요.

/init을 실행해서 이 프로젝트의 CLAUDE.md 초안을 만들어 줘. 그다음 "이모지는 쓰지 않는다"는 규칙을 한 줄 추가해 줘.

CLAUDE.md에 [자주 반복해서 말하는 규칙 한 줄]을 추가해 줘. 이미 비슷한 규칙이 있으면 합쳐 줘.