[Claude Code 입문 E21] CLAUDE.md 프로젝트 지침: 위치, 작성 4원칙, @임포트, 팀 공유

Claude Code에게 영속적인 지시를 전달하는 CLAUDE.md 파일을 다룹니다. 매 세션마다 빌드 명령, 컨벤션, 폴더 구조를 반복 설명하는 문제를 해결하는 방법부터 4가지 위치별 우선순위, 작성 4원칙, @ 임포트, 팀 공유, 트러블슈팅까지 정리합니다. 📌 다루는 내용 - CLAUDE.md란: 영속적 지시 전달 파일 / Auto memory와의 차이 - 4가지 위치와 우선순위: Managed policy / Project / User / Local (CLAUDE.local.md) - /init으로 자동 생성하기 (CLAUDE_CODE_NEW_INIT=1 인터랙티브 흐름) - 작성 4원칙: Size(200줄 이하) / Structure(마크다운) / Specificity(검증 가능) / Consistency(충돌 제거) - 섹션별 작성 가이드: 프로젝트 정보, 빌드 명령, 코딩 컨벤션, 폴더 구조, Git 컨벤션, 주의사항 - @ 임포트: 최대 5단계 재귀, 상대/절대 경로, AGENTS.md 호환 - 팀 Git 공유와 /memory 명령으로 로드 확인 - /compact 이후 재주입 동작 - 트러블슈팅: 지시 미준수, 파일 크기 과다, 팀원 간 동작 차이, HTML 주석 📌 환경 정보 - Claude Code CLI 설치 및 인증 완료 (E08~E10 참고) - 프로젝트 루트 또는 ~/.claude/ 디렉토리 접근 권한 - Git (팀 공유 시) 📌 챕터 0:40 CLAUDE.md란 1:58 어디에 두어야 하는가 3:20 /init으로 자동 생성 4:11 효과적인 작성 4원칙 5:42 섹션별 작성 가이드 7:50 @ 임포트로 다른 문서 참조 9:32 AGENTS.md와 호환하기 10:10 CLAUDE.local.md와 사용자 전역 설정 11:22 팀과 Git으로 공유하기 11:55 /memory와 /compact 동작 14:11 트러블슈팅과 정리 📌 참고 링크 - 블로그: https://neosarchizo.github.io/posts/claude-code-21-claude-md-project-guidelines - 공식 문서 Memory: https://code.claude.com/docs/en/memory - CLI reference: https://code.claude.com/docs/en/cli-reference - Quickstart: https://code.claude.com/docs/en/quickstart - Skills: https://code.claude.com/docs/en/skills #ClaudeCode #CLAUDEmd #프로젝트지침