안드레 카파시가 알려준 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-CLAUDE-md-35df7725c9d981c3a349c2e9745bf013?pvs=73 ▶️ 안트로픽 공식 메모리 가이드 (한국어) - CLAUDE.md 파일이 로드되는 방식: https://code.claude.com/docs/ko/memory#claude-md-%ED%8C%8C%EC%9D%BC%EC%9D%B4-%EB%A1%9C%EB%93%9C%EB%90%98%EB%8A%94-%EB%B0%A9%EC%8B%9D - 효과적인 지침 작성(4가지 요소): https://code.claude.com/docs/ko/memory#%ED%9A%A8%EA%B3%BC%EC%A0%81%EC%9D%B8-%EC%A7%80%EC%B9%A8-%EC%9E%91%EC%84%B1 ▶️ 영상에서 시연한 플러그인·스킬 - 안드레이 카파시 스킬 모음: https://github.com/forrestchang/andrej-karpathy-skills - 안트로픽 공식 claude-md-management 플러그인: https://github.com/anthropics/claude-plugins-official/tree/main/plugins/claude-md-management 📺 클로드 코드 시리즈 이 영상은 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만원 사용 방법: 결제 페이지에서 쿠폰 코드 입력 시 즉시 할인