안드레 카파시가 알려준 CLAUDE.md 의 비밀: CLAUDE.md 에 절대 쓰면 안되는 것

CLAUDE.md 작성법 완전 정복 — Claude Code가 같은 실수 안 하게 만드는 법 | 4가지 위치, 크기 관리, 안트로픽 공식 플러그인까지

CLAUDE.md를 README처럼 쓰고 계신가요? 그러면 토큰만 낭비하고 Claude는 같은 실수를 반복합니다. 이 영상에서는 CLAUDE.md의 정확한 작동 원리(4가지 자동 로드 위치 + 8-layer 컨텍스트 모델)부터, 왜 always-on 비용 때문에 크기가 중요한지, 좋은 CLAUDE.md를 쓰는 4가지 원칙과 high-ROI 워크플로우, 그리고 안트로픽 공식 plugin인 claude-md-management로 자동 다이어트하는 데모까지 25분에 정리합니다.

⏱️ 타임스탬프
0:00 하이라이트
0:26 인트로 — CLAUDE.md는 README가 아니다
2:23 섹션 1 — CLAUDE.md는 어떻게 작동하는가 (4가지 위치)
4:31 섹션 2 — 컨텍스트의 8 개 레이어
5:52 섹션 3 — 좋은 CLAUDE.md 쓰는 법 (Non-obvious invariants + High-ROI 워크플로우 + @import)
12:40 섹션 4 — 플러그인과 스킬로 관리하기 (claude-md-management 데모 + Karpathy 스킬)
22:14 마무리 — CLAUDE.md 체크리스트 6가지

🔗 오늘 영상에서 언급된 자료

▶️ 영상 한 페이지 치트시트 (노션) — 작동 원리, 작성 팁, 체크리스트까지 한 페이지 정리
- https://raspy-roll-970.notion.....site/Claude-Code-CLA

▶️ 안트로픽 공식 메모리 가이드 (한국어)
- CLAUDE.md 파일이 로드되는 방식: https://code.claude.com/docs/k....o/memory#claude-md-%
- 효과적인 지침 작성(4가지 요소): https://code.claude.com/docs/k....o/memory#%ED%9A%A8%E

▶️ 영상에서 시연한 플러그인·스킬
- 안드레이 카파시 스킬 모음: https://github.com/forrestchan....g/andrej-karpathy-sk
- 안트로픽 공식 claude-md-management 플러그인: https://github.com/anthropics/....claude-plugins-offic

📺 클로드 코드 시리즈
이 영상은 Claude Code 시리즈의 일부입니다. CLAUDE.md 기초가 처음이라면 1편 입문편을 먼저 보시는 걸 추천드려요.
▶️ 1편 입문: CLAUDE.md 세팅, 단축키, 필수 명령어 — https://www.youtube.com/watch?v=ZZVw8m7b36w&t=66s
▶️ 2편 실전: 컨텍스트 관리, 워크플로우 — https://www.youtube.com/watch?v=DCsv0rKKrN4&t=953s
▶️ 3편 고급: 스킬, Sub-Agent, Hooks, 병렬 실행 — https://www.youtube.com/watch?v=8H3NwQL-Aew&t=489s

💡 이 영상에서 다루는 핵심
✅ CLAUDE.md 자동 로드 4가지 위치 — 전역 / 팀 공유 / 개인 per-repo / 서브디렉토리
✅ 8-layer 컨텍스트 모델 — 어떤 규칙이 어떤 우선순위로 적용되는가
✅ "Non-obvious invariants only" 원칙 — 코드로 알 수 있는 건 빼라
✅ High-ROI 워크플로우 — 실수가 발생한 그 순간 CLAUDE.md에 반영시키는 사이클
✅ 빌드·테스트·린트 명령어 명시 = 결과 품질 2~3배 향상
✅ @import 분할 관리 + AGENTS.md로 코덱스까지 한 파일로 커버
✅ /revise-claude-md, /claude-md-improver 공식 플러그인으로 자동 다이어트
✅ 안드레이 카파시가 공개한 워크플로우 스킬을 전역 CLAUDE.md에 셋업

🔑 한 줄로 기억해두세요
"CLAUDE.md는 인간이 읽는 README가 아니라, Claude가 같은 실수를 안 하게 하는 instructions"

🔔 영상이 도움이 됐다면 구독과 좋아요 부탁드립니다!
💬 여러분이 CLAUDE.md에 꼭 넣는 규칙이나, Claude가 자주 하는 실수가 있다면 댓글로 공유해 주세요. 다음 영상 주제에 반영하겠습니다.

💬 오픈카톡 커뮤니티: https://open.kakao.com/o/g3Os2Lri

🎓 5월 신규 강의 (패스트캠퍼스): https://fastcampus.info/42hEDQx
🎁 얼리버드 쿠폰 (선착순 · ~26.05.10(일) 23:59)
쿠폰 코드: 실밸개발자youtube
할인 금액: 4만원
사용 방법: 결제 페이지에서 쿠폰 코드 입력 시 즉시 할인