클로드 코드에게 매번 "우리 프로젝트는 이 명령어로 테스트해", "들여쓰기는 2칸이야"를 설명하기 번거롭죠? CLAUDE.md 파일 하나면 그걸 자동으로 기억시킬 수 있어요. (시리즈 세 번째 꿀팁 🙂)
📌 CLAUDE.md가 뭐예요?
프로젝트 폴더에 두는 메모예요. 클로드 코드가 세션을 시작할 때마다 자동으로 읽어서, 거기 적힌 명령어·코드 스타일·규칙을 계속 기억해요. 매번 다시 설명할 필요가 없죠.
🤝 팀과 공유돼요
./CLAUDE.md 를 git에 올리면 팀원 모두가 똑같은 맥락을 공유해요. "우리는 npm 말고 pnpm 써" 같은 규칙을 한 번만 적으면 끝.
⚡ 만들기는 /init 한 방
클로드 코드에서 /init 를 입력하면 프로젝트를 분석해 초안을 자동으로 만들어줘요. 이미 있으면 덮어쓰지 않고 개선점을 제안해요. (내용을 보거나 고칠 땐 /memory.)
💡 뭘 적을까요?
• 자주 쓰는 명령어 (빌드·테스트·린트)
• 코드 스타일 (들여쓰기·세미콜론·네이밍)
• 폴더 구조 · 커밋 규칙 · "항상 ~하기" 규칙
👉 핵심은 짧고 구체적으로! 매 세션에 통째로 들어가니(=토큰 비용) 200줄 이내로, "깔끔하게" 대신 "2칸 들여쓰기"처럼 콕 집어 적는 게 좋아요.
⚠️ 주의 2가지
• 비밀번호·API 키는 넣지 마세요 (git에 그대로 올라가요). 개인 설정은 CLAUDE.local.md + .gitignore로.
• CLAUDE.md는 '안내'지 강제는 아니에요. 반드시 지켜야 하는 규칙은 '훅(hooks)'으로 강제할 수 있어요 — 이 시리즈 뒤쪽에서 다룰게요!
(클로드 코드 v2.1 기준 · 공식 문서: code.claude.com/docs 메모리 항목)
여러분 프로젝트라면 CLAUDE.md 맨 윗줄에 어떤 규칙을 적고 싶으세요? 댓글로 알려주세요 👇
