- CLAUDE.md 파일이란?
CLAUDE.md는 Claude Code에게 프로젝트의 기본 규칙과 작업 방향을 전달하는 Markdown 문서입니다.
예를 들어 홈페이지를 개발할 때 다음과 같은 내용을 설정할 수 있습니다.
사용 기술: Next.js, TypeScript, Tailwind CSS
디자인 규칙: 깔끔하고 모던한 디자인
코딩 규칙: 기존 코드 구조 유지
작업 원칙: 불필요한 파일 수정 금지
응답 언어: 모든 설명은 한국어로 작성
Claude Code는 작업을 시작할 때 관련 CLAUDE.md 파일을 읽고 지침으로 활용합니다.
- CLAUDE.md 파일 생성 방법
VS Code에서 프로젝트의 최상위 폴더에 다음 이름으로 파일을 생성합니다.
CLAUDE.md
파일 이름은 CLAUDE.md로 작성해야 합니다.
Claude Code 터미널에서 다음 명령어를 실행해 초기 지침 파일을 생성하거나 기존 파일을 개선할 수도 있습니다.
/init
- CLAUDE.md 작성 예시
아래는 Next.js 홈페이지 개발을 위한 간단한 예시입니다.
프로젝트 개발 지침
개발 환경
- Next.js
- TypeScript
- Tailwind CSS
- shadcn/ui
코딩 규칙
- 기존 프로젝트 구조를 최대한 유지한다.
- 불필요한 라이브러리는 설치하지 않는다.
- 컴포넌트는 재사용할 수 있도록 작성한다.
- 수정한 코드의 오류 여부를 확인한다.
디자인 규칙
- 미니멀하고 모던한 디자인을 유지한다.
- 모바일과 PC 화면에 모두 대응한다.
- 기존 디자인을 임의로 변경하지 않는다.
AI 응답 규칙
- 모든 설명은 한국어로 작성한다.
- 코드 수정 내용과 이유를 간단히 설명한다.
- 중요한 변경 사항은 작업 전에 알린다.
- CLAUDE.md 파일의 장점
① 반복 설명 최소화
매번 개발 환경이나 코딩 규칙을 설명할 필요가 없습니다.
② 일관된 코드 작성
프로젝트 전체에서 동일한 개발 규칙을 유지하는 데 도움이 됩니다.
③ 불필요한 수정 방지
AI가 기존 디자인이나 코드 구조를 임의로 변경하는 상황을 줄일 수 있습니다.
④ 프로젝트 관리 효율 향상
새로운 대화에서도 프로젝트의 기본 규칙을 전달할 수 있습니다.
- CLAUDE.md와 PRD.md의 차이
구분
CLAUDE.md
PRD.md
목적
AI 작업 지침
제품 요구사항 정의
주요 내용
코딩 규칙, 개발 환경
기능, 목표, 사용자 요구
역할
어떻게 개발할 것인가
무엇을 개발할 것인가
PRD.md는 만들고자 하는 프로그램의 요구사항을 정리하는 문서이고, CLAUDE.md는 AI가 작업할 때 지켜야 할 규칙을 정리하는 문서입니다.
두 파일을 함께 활용하면 AI 코딩 작업을 더욱 체계적으로 진행할 수 있습니다.
마무리
CLAUDE.md는 AI 코딩을 시작할 때 만들어두면 유용한 프로젝트 지침서입니다.
특히 Claude Code를 이용해 홈페이지를 지속적으로 수정하고 개선한다면 개발 규칙과 주의사항을 명확히 정리해 두는 것이 좋습니다.
단, CLAUDE.md가 AI의 모든 행동을 완벽하게 통제하는 것은 아닙니다. 중요한 작업 결과는 직접 확인하고, 프로젝트가 변경되면 지침 파일도 함께 업데이트해야 합니다