CLAUDE.md로 Claude AI 프로젝트 규칙 유지하기: 완벽 가이드

한 Reddit 사용자는 프로젝트 루트에 CLAUDE.md 파일을 추가하는 것이 Claude Code로 작업하면서 경험한 가장 효율적인 변화라고 보고했습니다. Claude는 모든 세션이 시작될 때 이 파일을 자동으로 읽어들이므로, TypeScript 사용법, Tailwind vs CSS 모듈, 테스트 폴더 구조, 데이터 모델 관계와 같은 규칙을 다시 설명할 필요가 없습니다.

주요 세부 사항

위치: 프로젝트 디렉토리 루트에 CLAUDE.md라는 파일을 만듭니다.
포함할 내용: 코딩 규칙(예: "항상 TypeScript를 사용합니다. default export는 금지합니다. Tailwind를 사용하며 CSS 모듈은 사용하지 않습니다. 테스트는 tests 폴더에 넣습니다.") 및 프로젝트 아키텍처 컨텍스트—모듈 연결 방식, 데이터 모델, 중요한 파일과 기본적인 파일의 구분 등.
동작 방식: 파일은 모든 Claude 세션 시작 시 자동으로 읽힙니다. 수동으로 호출할 필요가 없습니다. 규칙은 별도 요청 없이 적용됩니다.
결과: 사용자는 "Claude의 수정 결과가 세션 시작부터 컨텍스트가 적용되면서 눈에 띄게 좋아졌다"고 전했습니다.

사용 예시

# CLAUDE.md

규칙

언어: TypeScript
내보내기: named export만 사용 (default export 금지)
스타일링: Tailwind CSS (CSS 모듈 사용 안 함)
테스트: dedicated tests/ 폴더에 배치

아키텍처

프론트엔드: React with React Router
API 레이어: /api 내 Express 라우트
데이터 모델: /prisma 내 Prisma 스키마
중요 파일: /src/app.ts, /src/config.ts
이 파일을 추가한 후, 사용자는 더 이상 세션마다 규칙을 다시 입력할 필요가 없다고 보고했습니다.
대상
Claude Code 또는 Claude 기반 코딩 에이전트를 사용하며, 채팅 세션 간 일관된 동작을 원하고 반복적인 지시를 피하고자 하는 개발자.
📖 전체 출처 읽기: r/ClaudeAI