개념한 문장
세션마다 항상 주입되는 규칙 파일
CLAUDE.md는 작업 폴더에 두면 Claude가 매 세션 시작마다 읽는 파일입니다. 트랙 A의 지침과 같은 역할을, 에이전트 환경에서 합니다.
한 문장으로정보의 중복이 성능 하락과 비용 증가의 핵심 원인입니다. 많이 넣는 게 아니라 제대로 넣습니다.
원칙네 가지
무엇을 넣고 무엇을 빼나
① 중복 정보를 넣지 않는다
React 18 · TypeScript 같은 정보는 Claude가 package.json을 열어 스스로 압니다.
불일치의 함정실제 package.json은 19인데 CLAUDE.md엔 18로 적혀 있다면 — 이 불일치가 오히려 성능을 떨어뜨립니다.
② /init은 지양한다
프로젝트 전체를 훑어 시간·토큰을 크게 쓰고, AI가 스스로 알 수 있는 뻔한 정보를 기록합니다. 직접 쓰는 편이 낫습니다.
③ 금지엔 반드시 대안을 붙인다
| ❌ 이렇게 쓰면 | ✅ 이렇게 써야 |
|---|---|
| Lodash 쓰지 마라 → AI가 다른 걸 임의 선택 | Lodash 금지 — 대신 Native Array/Object 사용 → 의도대로 |
④ 200줄을 넘기면 조건부 규칙으로
공식 문서는 200줄 이내를 권장합니다. 넘치면 별도 규칙 파일에 프론트매터로 적용 조건을 겁니다.
--- applyTo: "src/**/*.ts" # 이 경로의 TS 파일을 건드릴 때만 주입 --- - 상태 관리는 Zustand만 사용 (Redux 금지) - API 호출은 services/ 레이어를 통해서만
실습15분
우리 프로젝트의 CLAUDE.md 쓰기
우리 프로젝트의 CLAUDE.md 초안을 만들어줘. 단, 아래 규칙을 지켜. - package.json 등 파일을 보면 알 수 있는 정보는 넣지 말 것 - 팀 컨벤션 / 금지사항(+대안) / 아키텍처 결정 이유만 - 30줄 이내 - 내가 알려줄 내용: (여기에 팀 규칙 3~5개 적기)
- 파일만 봐선 모르는 것만 남겼다
- 금지 항목에 대안을 함께 적었다
- 200줄을 넘지 않는다
클로드코드 시작하기트랙 B · 개발자