Claude Code를 사용하기 시작했지만 "생각보다 똑똑하지 않다"고 느낀 적이 없으신가요?

그 원인은 거의 확실하게 CLAUDE.md의 설계에 있습니다.

이 기사에서는 해외 상급자들이 실천하고 있는 CLAUDE.md의 설계 원칙을 실제 샘플 코드와 함께 해설합니다.

CLAUDE.md란 무엇인가

CLAUDE.md는 프로젝트의 .claude/ 폴더에 배치하는 Markdown 파일입니다. Claude Code는 세션 시작 시 이 파일을 자동으로 읽어옵니다.

원칙 1: 길이는 50~150행 이내로 유지하기

50~150행이 최적입니다. 200행을 초과하면 효과가 0에 가까워집니다.

원칙 2: 필수 3가지 규칙을 작성하기

• Diagnose before fixing (수정하기 전에 진단할 것)
• Smallest change only (최소한의 변경만 수행할 것)
• Ask when unclear (불명확할 때는 질문할 것)

원칙 3~7

• 프로젝트 타입을 명시하기
• 금지 사항을 명시하기 (예: NEVER modify .env files 등)
• 컨텍스트 관리의 30% 규칙 (/compact at 30%)
• 워크플로우 (Workflow) 정의하기
• 2주마다 검토하기

무료 템플릿 배포 중

GitHub: https://github.com/noguso245-jpg/claude-code-starter

BOOTH (완전판 ¥9,800): https://streamsolty.booth.pm/items/8413724

Discussion