본문으로 건너뛰기

CLAUDE.md 및 메모리 파일

초급

Claude Code를 더 좋게 만들려고 한 가지만 한다면, 이것을 하세요. CLAUDE.md는 Claude가 매 세션 시작에 읽는 평문 파일 — 프로젝트의 영구 브리핑입니다.

What you'll learn
  • CLAUDE.md가 왜 단일 최고 레버리지의 Claude Code 설정인지
  • 메모리 계층이 전역에서 프로젝트별로 어떻게 병합되는지
  • /init로 시작 파일을 생성하고 다듬는 법
  • CLAUDE.md에 무엇이 들어가고 — 무엇을 빼야 하는지
  • @imports로 문서를 중복 없이 참조하는 법

왜 가장 레버리지가 큰 설정인가​

이것이 없으면 매 세션마다 프로젝트를 다시 설명하게 됩니다("우리는 pnpm을 쓰고, 테스트는 __tests__에 있고, /generated는 건드리지 말고…"). 이것이 있으면 Claude가 이미 압니다. 여기 좋은 지침은 모든 미래 상호작용을 한 번에 개선합니다.

메모리 계층​

Claude Code는 여러 곳에서 메모리를 읽고 병합하며, 대략 가장 전역적인 것에서 가장 구체적인 것 순입니다:

  • 사용자 메모리 — 모든 프로젝트에 걸친 개인 선호.
  • 프로젝트 메모리 (./CLAUDE.md, 커밋됨) — 이 저장소가 어떻게 작동하는지. 팀과 공유됩니다.
  • 중첩 — 그곳에만 적용되는 규칙을 위해 하위 폴더에 CLAUDE.md를 두세요.
메모리 계층 알기
Enter 또는 스페이스 키를 눌러 카드를 뒤집습니다. 좌우 화살표 키로 카드를 이동할 수 있습니다.용어가 표시되었습니다.
1 / 4

시작점 생성하기​

Guided walkthrough1 of 3
  1. Claude가 코드를 검사하고 자동으로 CLAUDE.md 초안을 작성합니다.

Generate a draft CLAUDE.md

/init

CLAUDE.md 템플릿에서 완성된 스타터를 가져오세요.

무엇을 넣을까​

  • 프로젝트가 무엇인지, 두 문장으로.
  • 기술 스택과 실행 / 테스트 / 린트 방법.
  • Claude가 추론할 수 없는 관례(명명, 구조, 커밋 스타일).
  • 가드레일: "완료 선언 전 테스트 실행", "/vendor 절대 편집 금지", "비밀 절대 커밋 금지".

무엇을 넣지 말까​

Watch out
  • Claude는 CLAUDE.md를 문자 그대로 따릅니다 — 낡거나 모호하거나 희망사항인 지침은 오히려 해칩니다.
  • 프로젝트가 오늘 실제로 어떻게 작동하는지 기술하세요; 짧고 참인 것이 길고 이상적인 것보다 낫습니다.
  • 거대한 붙여넣기 문서(대신 @imports 사용), 비밀, 실제로 따르지 않는 규칙은 피하세요.
  • 프로젝트가 진화함에 따라 정확하게 유지되도록 주기적으로 검토하세요.

임포트​

문서를 복제하는 대신 기존 문서를 끌어오세요 — 예를 들어 @path/to/file 임포트로 스타일 가이드를 참조해 단일 진실 소스를 유지하세요. 정확한 문법은 공식 메모리 문서를 참고하세요.

Pro tip
  • 단일 진실 소스: CLAUDE.md에 내용을 붙여넣기보다 @imports로 파일을 참조하세요.
  • 문서가 이미 있으면 링크하세요 — 복사하지 마세요. 사본은 오래되어 어긋납니다.

스스로 점검하기​

스스로 점검하기

0/3
  1. Claude Code가 매 세션 시작에 프로젝트의 영구 브리핑으로 읽는 파일은?
  2. 프로젝트에서 /init을 실행하면 무엇을 하나요?
  3. 스타일 가이드 같은 큰 기존 문서를 포함하는 권장 방법은?
Key takeaways
  • CLAUDE.md는 가장 레버리지가 큰 설정입니다: 모든 미래 세션을 한 번에 개선합니다.
  • 메모리는 전역에서 구체적으로 병합됩니다: 엔터프라이즈 정책, 그다음 사용자, 프로젝트, 중첩 CLAUDE.md 파일.
  • /init로 시작한 뒤, 초안을 실제로 참인 것으로 다듬으세요.
  • 프로젝트 요약, 실행/테스트/린트 명령, 관례, 가드레일을 포함하세요.
  • 짧고 참되게 유지하세요 — 큰 문서에는 @imports를 쓰고, 비밀은 절대 커밋하지 마세요.

다음​