CLAUDE.md

정의#

CLAUDE.md는 특정 프로젝트·폴더 안에서 Claude가 따라야 할 규칙, 선호, 금기, 자주 쓰는 프롬프트를 모아 두는 마크다운 파일이다. Claude Code·Claude Cowork은 세션이 시작될 때 이 파일을 자동으로 읽어 컨텍스트에 넣는다.

왜 필요한가#

AI 팀원은 매 세션마다 기억이 초기화되는 신입이다. 전날 알려준 “표 헤더 볼드 금지”, “환율은 서울외국환중개 기준” 같은 업무 규칙은 다음 세션에 전달되지 않는다. CLAUDE.md는 이 문제를 해결한다 — 새 팀원에게 주는 한 장짜리 매뉴얼처럼, 항상 같은 규칙이 자동 주입된다.

전형적인 섹션#

• 작업 방식 — 역할 분리, 설계 먼저, 출처 포함 등 일하는 방식
• 오답노트 — 과거에 잘못 나왔던 결과와 그 원인·교정 규칙
• 자주 쓰는 프롬프트 — 반복되는 요청 템플릿
• 금칙어·스타일 가이드 — 브랜드 톤, 표현 제약

성장 곡선#

처음부터 완벽할 필요가 없다. Day 1에는 3줄이어도 괜찮고, 한 달 동안 시행착오를 겪으며 한 줄씩 쌓으면 수십 줄짜리 업무 매뉴얼이 된다. CLAUDE.md가 두꺼워질수록 AI가 일을 더 잘한다.

skill과의 차이#

• Skill — 특정 업무 하나를 처음부터 끝까지 수행하는 재사용 단위
• CLAUDE.md — 프로젝트 전반에 걸쳐 모든 Skill·대화에 공통 적용되는 전역 규칙·취향·컨텍스트