Ch.5 Claude Code 핵심 기능

CLAUDE.md — AI에게 주는 프로젝트 설명서

CLAUDE.md의 역할과 중요성을 설명할 수 있다CLAUDE.md에 포함할 핵심 항목 4가지를 안다프로젝트 루트와 하위 폴더 CLAUDE.md의 차이를 이해한다

새 팀원이 왔는데 매번 같은 설명을 반복해야 한다면?

프로젝트에 새 개발자가 합류할 때마다 '이 폴더는 이런 용도야', '이 규칙은 꼭 지켜야 해'를 반복 설명합니다. AI에게도 매번 같은 말을 반복해야 할까요?

매 대화마다 프로젝트 구조와 규칙을 설명하면 시간도 토큰도 낭비됩니다.

CLAUDE.md가 해답입니다. 한 번 작성하면 AI가 매 대화 시작 시 자동으로 읽어, 일관된 품질을 보장합니다.

article

핵심 내용

CLAUDE.md = 프로젝트의 '사용설명서' AI가 대화를 시작할 때마다 자동으로 읽는 파일

비유하면 신입사원에게 주는 온보딩 문서입니다. 프로젝트 구조, 코딩 규칙, 주의사항이 적혀 있으면 매번 설명할 필요가 없습니다. AI도 마찬가지입니다.

CLAUDE.md가 있으면 모든 대화에서 일관된 품질

/init 명령어가 기본 CLAUDE.md를 자동 생성해주지만, 직접 보강해야 효과적입니다.

프로젝트 루트의 CLAUDE.md는 전체 규칙, 하위 폴더의 CLAUDE.md는 해당 영역 규칙. AI가 둘 다 읽습니다.

좋은 CLAUDE.md의 비밀: '절대 금지' 항목이 가장 중요합니다. AI가 실수하기 쉬운 패턴을 미리 막아두면, 반복적인 수정 요청을 줄일 수 있습니다.

CLAUDE.md 생성 터미널 데모

CLAUDE.md 마스터

key

📁

주요 폴더와 각 폴더의 역할

🛠️

사용 중인 프레임워크와 라이브러리

📏

네이밍 규칙, 파일 구조 규칙

🚫

절대 하면 안 되는 것들

image

다이어그램: cc-d005

check_circle

퀴즈와 인터랙션으로 더 깊이 학습하세요