새 직원이 들어오면 업무 매뉴얼을 줍니다. "우리 팀은 보고서를 이 형식으로 쓰고, 고객 이름은 절대 외부에 공개하지 않는다." Claude Code도 마찬가지입니다. 매뉴얼을 써놓으면 매번 말할 필요가 없습니다.
CLAUDE.md가 뭔가요
프로젝트 폴더에 넣어두는 텍스트 파일입니다. Claude Code가 시작될 때 이 파일을 자동으로 읽고, 그 안에 적힌 규칙을 따릅니다.
비유하자면 이렇습니다.
| 회사 | Claude Code |
|---|---|
| 부서 업무 매뉴얼 | CLAUDE.md 파일 |
| 매뉴얼을 읽고 일하는 직원 | Claude Code |
| "항상 존댓말로 써", "약어 쓰지 마" | CLAUDE.md에 적은 규칙 |
매번 "한국어로 써줘"라고 말하는 대신, CLAUDE.md에 한 번만 적어두면 됩니다. Claude Code가 알아서 읽고 지킵니다.
어디에 만들고, 어떻게 만드나요
위치
작업 폴더 최상위에 CLAUDE.md라는 이름으로 만듭니다.
| 위치 | 파일명 | 적용 범위 |
|---|---|---|
| 작업 폴더 | ./CLAUDE.md | 이 프로젝트에서만 적용 |
| 홈 폴더 | ~/.claude/CLAUDE.md | 모든 프로젝트에 공통 적용 |
| 작업 폴더 | ./CLAUDE.local.md | 나만 쓰는 개인 규칙 (.gitignore에 추가하면 git에 안 올라감) |
처음 시작할 때는 작업 폴더에 ./CLAUDE.md 하나만 만들면 됩니다. 나머지는 나중에 필요할 때 추가하면 됩니다.
만드는 방법 3가지
1 Claude Code한테 시키기 (가장 쉬움)
Claude Code 입력창에 이렇게 말하면 됩니다.
내용은: 항상 한국어로 작성하고, 과장 표현 쓰지 마.
파일을 만들겠다고 물어보면 "y"를 누르세요.
2 /init 명령어 사용
Claude Code가 폴더 구조를 분석해서 CLAUDE.md 초안을 자동으로 만들어줍니다. 내용을 수정하고 싶으면 /memory를 입력하면 편집 화면이 열립니다.
3 직접 만들기
메모장이나 텍스트 편집기에서 CLAUDE.md 파일을 직접 만들어도 됩니다. 확장자가 .md인 일반 텍스트 파일입니다.
3편 — 10분이면 끝나는 설치 따라하기를 먼저 읽어주세요.
뭘 써야 하나요 — 3줄이면 충분합니다
복잡하게 생각할 필요 없습니다. 세 가지만 적으면 됩니다.
- 용도 — 이 폴더에서 뭘 하는지
- 규칙 — 지켜야 할 것
- 금지사항 — 하면 안 되는 것
실제 예시를 보겠습니다.
## 이 폴더의 용도
블로그 글 초안을 작성하는 곳입니다.
## 규칙
- 항상 한국어로 작성
- 과장 표현 금지
- 출처 없는 통계 사용 금지
## 하면 안 되는 것
- 고객 실명 노출 금지
- 기존 파일을 물어보지 않고 덮어쓰기 금지
이게 전부입니다. 이 파일을 폴더에 넣어두면, Claude Code는 매번 시작할 때 이 규칙을 읽고 따릅니다. "한국어로 써줘"를 다시 말할 필요가 없습니다.
3줄로 시작해서, 쓰다 보면 "이것도 추가해야겠다" 싶은 게 생깁니다. 그때마다 한 줄씩 추가하면 됩니다. CLAUDE.md는 쓰면서 계속 고치는 파일입니다.
비개발자용 템플릿 3가지
아래 세 가지 중 본인 업무에 맞는 걸 복사해서 그대로 쓰면 됩니다.
템플릿 1 — 리서치/조사용
이런 분께 맞습니다: 시장 조사, 경쟁사 분석, 자료 정리를 주로 시키는 경우
## 이 폴더의 용도
시장 조사와 자료 정리를 하는 곳입니다.
## 규칙
- 항상 한국어로 작성
- 출처가 있는 정보만 사용하고, 출처 URL 포함
- 숫자/통계는 반드시 원본 확인 후 작성
- 결론을 먼저 쓰고, 근거를 뒤에 배치
## 하면 안 되는 것
- 출처 없는 통계 사용 금지
- "~인 것으로 보입니다" 같은 애매한 표현 금지
- 기존 파일 덮어쓰기 금지 (물어보고 진행)
템플릿 2 — 콘텐츠 제작용
이런 분께 맞습니다: 블로그 글, 뉴스레터, SNS 글을 쓰는 경우
## 이 폴더의 용도
블로그 글과 SNS 콘텐츠를 작성하는 곳입니다.
## 규칙
- 한국어로 작성, 존댓말(~합니다) 사용
- 문단은 4줄 이하로 짧게
- 전문 용어가 나오면 괄호 안에 쉬운 설명 추가
- 글 마지막에 핵심 요약 1줄 포함
## 하면 안 되는 것
- "획기적인", "혁신적인" 같은 과장 표현 금지
- 이모지 사용 금지
- 다른 사람 글 표절 금지
템플릿 3 — 업무 문서용
이런 분께 맞습니다: 보고서, 기획서, 회의록을 정리하는 경우
## 이 폴더의 용도
업무 보고서와 회의록을 작성하는 곳입니다.
## 규칙
- 한국어로 작성
- 보고서 형식: 제목 → 요약 → 본문 → 다음 단계
- 날짜는 YYYY-MM-DD 형식 사용
- 파일 이름은 "문서종류-날짜.md" 형식
## 하면 안 되는 것
- 대외비 내용 외부 유출 금지
- 실명 노출 금지 (이니셜로 대체)
- 승인 없이 기존 보고서 수정 금지
나중에 추가하면 좋은 것들
3줄로 시작한 뒤, 쓰면서 느끼는 불편함을 하나씩 추가합니다.
- 자주 시키는 작업의 순서 — "블로그 글 쓸 때는 제목 → 개요 → 본문 → 요약 순서로"
- 자주 참고하는 파일 위치 — "양식은 templates/ 폴더에 있다"
- 내 선호사항 — "표보다 불릿 리스트를 선호한다", "영어 약어는 한국어 병기"
- 프로젝트별 용어 — "우리 팀에서 '고객'은 B2B 기업 담당자를 뜻한다"
실전 팁: Claude Code를 쓰다가 "아, 또 이 말을 해야 하네"라는 생각이 드는 순간이 있습니다. 그게 CLAUDE.md에 추가할 타이밍입니다. Claude Code한테 "방금 내가 말한 규칙을 CLAUDE.md에 추가해줘"라고 시키면 됩니다.
CLAUDE.md 작성 시 주의할 점
- 짧고 명확하게 — 길게 쓰면 AI도 핵심을 놓칩니다. 한 규칙당 한 줄이 이상적입니다.
- 구체적으로 — "잘 써줘"보다 "문단 4줄 이하, 존댓말 사용"이 훨씬 정확합니다.
- 비밀번호나 API 키는 절대 넣지 마세요 — CLAUDE.md는 일반 텍스트 파일이라 누구나 열어볼 수 있습니다.
- 파일 이름은 정확히 CLAUDE.md — 대소문자가 다르면 인식하지 못합니다.
자주 묻는 질문 (FAQ)
Q. CLAUDE.md를 수정하면 바로 적용되나요?
네. Claude Code를 새로 시작하면 수정된 내용이 자동으로 반영됩니다. 대화 도중에 수정한 경우에는 /memory를 입력하거나, 대화를 새로 시작하면 적용됩니다.
Q. CLAUDE.md 없이도 Claude Code를 쓸 수 있나요?
물론입니다. CLAUDE.md가 없어도 Claude Code는 정상 작동합니다. 다만 매번 같은 말을 반복해야 하는 불편함이 생길 뿐입니다. 반복되는 지시가 2~3개 이상 쌓이면 그때 만들어도 늦지 않습니다.
Q. 코딩 관련 내용만 써야 하나요?
전혀 아닙니다. "한국어로 써줘", "보고서 형식은 이렇게 해줘", "파일 덮어쓰지 마" 같은 일반 업무 규칙도 전부 작동합니다. 위 템플릿처럼 비개발자에게 맞는 규칙을 자유롭게 쓰면 됩니다.
정리하며
관점 한 스푼: AI를 처음 쓸 때 가장 지치는 건 어려운 기능이 아니라 반복입니다. 매번 "한국어로 써줘"를 치다 보면 "이게 정말 편한 건가?" 싶어집니다. CLAUDE.md는 그 반복을 없애주는 파일입니다. 3줄 적어놓으면 다음부터는 AI가 나를 이미 아는 것처럼 일합니다. 사소하지만, 이게 AI를 도구로 '진짜' 쓰기 시작하는 순간입니다.
다음 편에서는 AI가 까먹을 때 대화를 이어가는 법을 알아봅니다
8편 보러 가기 →
참고 자료
· Melon AI Insight — CLAUDE.md 가이드
· Claude Code 공식 문서 — Memory & CLAUDE.md
댓글
댓글 쓰기