CLAUDE.md 파일 작성법 Claude에게 프로젝트 규칙을 알려주는 지시서

📋

Claude의 기능들 2강

Claude에게 “이 프로젝트에서는 이렇게 작업해줘”라고 알려주는 지시서입니다

CLAUDE.md란?

CLAUDE.md는 Claude Code가 프로젝트 작업 시 항상 참고하는 지시서입니다. 여기에 적어둔 내용을 Claude가 매번 읽고, 그에 맞게 작업합니다.

💡
비유: 새로운 팀원에게 주는 “업무 가이드”와 같습니다. “우리 팀은 이렇게 일해요”를 한 번 적어두면, 매번 말하지 않아도 됩니다.

뭘 적어두면 좋을까?

📌

프로젝트 소개

이 프로젝트가 뭐하는 건지, 어떤 기술을 쓰는지 간단히 적어줍니다.

🔧

작업 방법

개발 서버 실행법, 테스트 방법 등 자주 하는 작업의 명령어를 적어둡니다.

📏

작업 규칙

“한국어로 설명해줘”, “파일 수정 전에 먼저 물어봐” 같은 규칙을 적습니다.

🚫

하지 말아야 할 것

“이 폴더는 건드리지 마”, “이 파일은 수정하지 마” 같은 금지사항을 적습니다.

작성 예시

CLAUDE.md 예시

# 프로젝트 소개
이 프로젝트는 교육용 웹사이트입니다.
Vue 3와 Vite를 사용하고 있습니다.

# 자주 쓰는 명령어
- 개발 서버 실행: npm run dev
- 배포용 파일 생성: npm run build

# 작업 규칙
- 설명은 항상 한국어로 해주세요
- 새 파일을 만들기 전에 먼저 물어봐주세요
- 주석도 한국어로 작성해주세요

# 폴더 안내
- src/courses/ — 강좌 콘텐츠가 들어있는 폴더
- src/components/ — 공통으로 쓰는 화면 조각들
- public/ — 이미지 등 정적 파일

# 주의사항
- src/courses/index.js는 새 강좌 추가 시 수정 필요
- .claude/ 폴더 안의 설정은 함부로 바꾸지 마세요

가장 쉽게 만드는 방법

직접 작성할 필요 없이, Claude에게 만들어달라고 하면 됩니다.

1

명령어로 자동 생성

방법 1

/init

/init을 실행하면 Claude가 프로젝트를 분석해서 CLAUDE.md를 자동으로 만들어줍니다.

2

대화로 요청

방법 2

이 프로젝트에 맞는 CLAUDE.md 파일을 만들어줘

Claude가 프로젝트 구조, 사용 기술, 파일 구성 등을 파악해서 알아서 작성해줍니다. 생성된 내용을 보고 필요한 부분만 수정하면 됩니다.

어디에 놓을 수 있나?

📂
프로젝트 폴더 (CLAUDE.md)

이 프로젝트 전체에 적용

“이 프로젝트는 Vue로 만들고 있어”
📁
하위 폴더 (src/CLAUDE.md)

해당 폴더에만 적용

“이 폴더의 파일은 TypeScript로 작성해”
💡
하위 폴더의 CLAUDE.md는 상위 내용에 추가로 적용됩니다. 상위 내용을 덮어쓰지 않습니다.

참고로 모든 프로젝트에 공통 적용하고 싶은 규칙이 있다면, 전역 설정 폴더에도 CLAUDE.md를 넣을 수 있습니다. 자세한 위치는 프로젝트 폴더 구조 페이지를 참고하세요.

잘 쓰는 팁

🚀
먼저 Claude에게 만들어달라고 하세요: /init 또는 “CLAUDE.md 만들어줘”가 가장 빠릅니다
🎯
구체적으로 쓰세요: “잘 해줘”보다 “한국어로, 존댓말로, 3줄 이내로”가 좋습니다
🔁
자주 반복하는 말을 적어두세요: 매번 같은 지시를 안 해도 됩니다
⛔
금지사항도 적으세요: 하면 안 되는 것을 명확히 해두면 실수가 줄어듭니다
📐
너무 길게 쓰지 마세요: Claude가 읽는 데도 용량이 소모됩니다