프로젝트 메모리와 CLAUDE.md

매번 "우리 프로젝트는 들여쓰기 2칸이고, 테스트는 vitest로 돌려"라고 설명하긴 번거롭습니다. Claude Code는 CLAUDE.md 파일을 통해 프로젝트의 규칙과 맥락을 기억합니다.

학습 목표

• CLAUDE.md의 역할과 위치를 이해한다.
• 어떤 내용을 적어 두면 좋은지 안다.
• 메모리가 작업 품질에 어떤 영향을 주는지 이해한다.

CLAUDE.md란

프로젝트 루트에 CLAUDE.md 파일을 두면, Claude Code가 세션을 시작할 때 그 내용을 자동으로 읽어 맥락으로 삼습니다. 코딩 규칙, 자주 쓰는 명령, 아키텍처 설명 등을 적어 두면 매번 반복해서 알려 줄 필요가 없습니다.

무엇을 적을까

# 프로젝트 규칙

## 코드 스타일
- 들여쓰기 2칸, 세미콜론 사용
- 컴포넌트는 함수형으로 작성

## 자주 쓰는 명령
- 개발 서버: npm run dev
- 테스트: npm test
- 린트: npm run lint

## 구조
- src/app: Next.js App Router 페이지
- src/lib: 데이터 접근·유틸

자주 틀리거나 매번 설명해야 했던 내용을 적어 두면 효과가 큽니다.

메모리 위치

• 프로젝트 메모리: 프로젝트 루트의 CLAUDE.md — 팀과 공유 (git에 커밋)
• 개인 메모리: 사용자 홈 디렉터리 — 모든 프로젝트에 공통 적용

프로젝트별 규칙은 프로젝트 메모리에, 개인 취향은 개인 메모리에 두는 식으로 구분합니다.

대화 중에 기억시키기

작업 중 "앞으로 이렇게 해줘"라고 알려 주면, 그 내용을 메모리에 추가하도록 요청할 수 있습니다.

> 앞으로 커밋 메시지는 한국어로 작성해줘. 이걸 기억해둬.

요약

CLAUDE.md는 프로젝트의 규칙과 맥락을 기록해 두는 메모리 파일입니다. 코드 스타일, 자주 쓰는 명령, 구조를 적어 두면 매번 설명하지 않아도 일관된 결과를 얻을 수 있습니다.