📋
IMPROVED
CLAUDE.md 설정 파일
Claude에게 프로젝트 규칙을 알려주는 설정 파일입니다. 한 번 만들어두면 매번 설명하지 않아도 돼요.
CLAUDE.md는 Claude Code가 프로젝트를 열 때 자동으로 읽는 설명서입니다. 프로젝트 구조, 코딩 규칙, 자주 쓰는 명령어, 하면 안 되는 것들을 적어두면 Claude가 항상 그대로 따릅니다.
CLAUDE.md 예시
# CLAUDE.md
## 명령어
```bash
npm run dev # 개발 서버
npm run build # 빌드 확인 (배포 전 항상 실행)
npm run test # 테스트
```
## 코딩 규칙
- TypeScript strict 모드 사용
- 컴포넌트는 app/components/에 저장
- API 응답은 항상 타입 정의
## 절대 하면 안 되는 것
- npm install --force 금지
- 환경변수 하드코딩 금지
- main 브랜치에 직접 push 금지
## 배포
- git push → Vercel 자동 배포
- 수동 배포: npx vercel --prod (지시 시에만)파일 우선순위 (낮은 것 → 높은 것)
관리자 정책 (조직 전체) ↓ 전역 개인 설정: ~/.claude/CLAUDE.md ↓ 프로젝트 공유: ./CLAUDE.md 또는 ./.claude/CLAUDE.md ↓ 모듈형 규칙: ./.claude/rules/*.md ↓ 개인 로컬: ./CLAUDE.local.md (git에 올라가지 않음) 더 구체적인 규칙이 우선순위 높음
@import로 파일 불러오기 (신기능)
# CLAUDE.md에서 다른 파일 참조
CLAUDE.md 내용:
아키텍처 상세: @docs/architecture.md
배포 절차: @docs/deployment.md
개인 설정: @~/.claude/my-preferences.md
→ CLAUDE.md를 짧게 유지하면서 필요한 정보 모두 포함
→ 재귀 import 깊이 5단계까지 지원.claude/rules/ 조건부 규칙
파일 패턴에 따라 자동으로 적용되는 규칙을 만들 수 있습니다. 예: src/api/**/*.ts 파일 작업 시에만 → .claude/rules/api.md에 paths frontmatter 추가 결과: API 파일 수정 시에만 API 관련 규칙 자동 적용
CLAUDE.md에 꼭 넣어야 할 것들
- •빌드·실행·테스트 명령어 (Claude가 추측하기 어려운 것)
- •기본값과 다른 코딩 스타일 규칙
- •절대 하면 안 되는 행동 목록
- •배포 방법과 주의사항
- •프로젝트 특유의 폴더 구조나 패턴
- •외부 서비스 연동 방법 (API 엔드포인트 등)
💡
/init 명령으로 Claude가 현재 프로젝트를 분석해서 CLAUDE.md 초안을 자동 생성해줍니다. 그 후 직접 수정해서 사용하세요.