CLAUDE.md 작성법 (업무 자동화용) — `CLAUDE.md`, 내 취향을 기억시킨다

7.1 매번 같은 말을 하고 있지 않나요

5장과 6장을 지나오면서 이런 말을 몇 번쯤 하셨을 겁니다.

“한국어로 답해줘”
“결과는 output 폴더에 저장해줘”
“원본 파일은 건드리지 마”
“설명 말고 결과만 줘”

그리고 새 대화를 열 때마다 처음부터 다시 말했을 겁니다. 3.4절에서 배운 대로입니다. 새 대화는 새 공책이고, 앞 공책의 내용을 모릅니다.

매번 다시 말하는 건 낭비입니다. 한 번만 적어두고 끝내는 방법이 있습니다.

7.2 `CLAUDE.md` — 신입에게 주는 사내 규칙

작업 폴더에 CLAUDE.md 라는 이름의 파일을 하나 두면, Claude가 매 대화를 시작할 때 그 파일을 자동으로 읽습니다.

📖 프로젝트 메모리(project memory) / CLAUDE.md

작업 폴더에 두는 규칙 파일. 파일 이름이 정확히 CLAUDE.md 여야 합니다. Claude는 대화를 시작할 때마다 이 파일을 읽고, 거기 적힌 규칙을 지킵니다.

대화가 끝나도 파일은 남습니다. 그래서 대화를 새로 열어도 규칙은 유지 됩니다.

비유하면 이렇습니다.

새 직원이 올 때마다 “우리 회사는 보고서를 이렇게 씁니다” 를 말로 설명하면, 사람이 바뀔 때마다 다시 해야 합니다.

사내 규정집을 한 장 써서 책상에 두면, 새로 온 사람이 알아서 읽습니다.

CLAUDE.md 가 그 규정집입니다.

여기서 3장과 7장이 이어집니다. 컨텍스트는 매번 비워지지만, 파일은 안 없어집니다. CLAUDE.md 는 사라지는 기억을 파일로 붙잡아 두는 장치입니다.

7.3 만들어 봅시다

작업 폴더에서 Claude에게 이렇게 말하세요.

이 폴더에 CLAUDE.md 파일을 만들어줘.
내용은 아래 규칙을 담아줘.
- 모든 답변은 한국어로
- 결과물은 output 폴더에 저장
- 원본 파일은 절대 덮어쓰지 않기

권한 창(쓰기) → 파일 이름이 CLAUDE.md 인지 확인 → 허용.

또는 직접 만들어도 됩니다. VS Code에서 New File → 이름을 CLAUDE.md 로 저장. 내용은 마크다운으로 씁니다(5.5절).

# 프로젝트 규칙

## 응답 언어
- 모든 응답은 한국어로 작성한다.

## 결과물 저장 위치
- 자동 생성된 결과물은 output 폴더에 저장한다.
- 입력 파일은 절대 덮어쓰지 않는다.

## 검수
- 결과물을 만든 뒤에는 한 줄 요약과 확인할 점 3개를 함께 출력한다.

잘 먹히는지 확인하기

새 대화를 엽니다. 그리고 아무 말이나 시켜보세요. 영어로 답하던 게 한국어로 오면 성공입니다.

더 확실한 확인법:

지금 이 프로젝트의 규칙이 뭐야?

CLAUDE.md 내용을 읊어주면 제대로 읽고 있는 겁니다.

7.4 뭘 적어야 하나

규칙을 뭐부터 적어야 할지 막막하실 겁니다. 네 칸으로 나눠서 생각하세요.

칸	무엇	예
말투·언어	어떻게 답하길 원하나	“한국어로”, “존댓말로”, “설명 빼고 결과만”
파일 위치	어디서 읽고 어디에 쓰나	“입력은 `input/`, 결과는 `output/`”
금지	절대 하지 말 것	“원본 덮어쓰기 금지”, “`.env` 파일 열지 말 것”
검수	끝나고 뭘 알려주나	“확인할 점 3개를 같이 알려줄 것”

네 번째 칸이 이 책에서 특히 중요합니다. 3장에서 배운 대로 AI는 틀립니다. “끝났습니다” 대신 “끝났고, 여기 세 군데는 확인해 보세요” 라고 말하게 만드는 게 검수 칸입니다. 10장에서 이어집니다.

이미 있는 걸 그대로 쓰지 마세요

⚠️ 남의 CLAUDE.md 를 복사해 오는 건 별로입니다

인터넷에 좋아 보이는 예시가 많습니다. 그런데 내 습관에서 나온 규칙이 아니면 소용이 없습니다.

제일 좋은 시작은 이겁니다 — 최근에 Claude에게 두 번 이상 말한 것을 적으세요. 두 번 말했다는 건 앞으로도 말할 거라는 뜻입니다.

7.5 규칙이 안 지켜질 때

자주 겪는 일입니다. CLAUDE.md 에 적었는데 안 지킵니다. 원인은 대개 셋입니다.

① 파일 이름이나 위치가 틀렸다

이름이 정확히 CLAUDE.md 인가요? (claude.md, CLAUDE.MD 아님)
작업 폴더 맨 위에 있나요? 하위 폴더에 있으면 안 읽습니다

② 규칙이 애매하다

❌ 안 지켜짐	✅ 지켜짐
“깔끔하게 작성한다”	“한 문단은 세 문장을 넘지 않는다”
“적절한 위치에 저장”	“결과는 `output/` 폴더에 저장한다”
“가급적 한국어로”	“모든 응답은 한국어로 작성한다”

6.3절과 똑같은 이야기입니다. 애매하면 안 통합니다.

③ 규칙이 너무 많다

⚠️ 규칙 파일이 길어지면 오히려 안 지켜집니다

스무 개를 적어두면 전부 흐려집니다. 사람도 그렇습니다.

다섯에서 열 개 사이로 유지하세요. 안 지켜지는 규칙은 지우고, 정말 중요한 것만 남기세요. 지우는 것도 관리입니다.

7.6 이게 사실 Skill의 예고편입니다

지금 하신 일을 한 문장으로 요약하면 이렇습니다.

AI에게 시킬 말을 미리 파일에 적어뒀고, AI가 알아서 읽었다.

이 문장을 기억해 두세요. 2부와 3부 전체가 이 문장의 확장판입니다.

번호	무엇을 적어두나	언제 읽히나
`CLAUDE.md`	늘 지킬 규칙	대화 시작할 때 자동으로
Skill (8장~)	특정 일의 절차	내가 부를 때만

둘은 형제입니다. 둘 다 마크다운 파일이고, 둘 다 “말로 하던 걸 파일에 적어둔 것” 입니다. 차이는 늘 적용되느냐, 불러야 적용되느냐 뿐입니다.

💡 이 책 전체를 관통하는 한 문장

“두 번 이상 말할 것 같으면, 파일에 적어라.”

규칙이면 CLAUDE.md, 절차면 Skill입니다. 이 감각 하나가 4주의 결론이고, 16장에서 여러분이 직접 하게 될 일입니다.

7.7 🔁 혼자 해보기

지금까지 Claude에게 두 번 이상 말한 것을 떠올려 적으세요. 세 개면 충분합니다
그걸 CLAUDE.md 로 만드세요
새 대화를 열어 잘 먹히는지 확인하세요
일부러 애매하게 적은 규칙을 하나 넣고, 안 지켜지는 걸 확인해 보세요. 그다음 그걸 구체적으로 고쳐서 지켜지는 걸 확인하세요

4번이 핵심 연습입니다. 애매함이 어떻게 실패하는지 눈으로 보면 앞으로 Skill을 쓸 때 훨씬 잘 씁니다.

7.8 1부를 마치며

1부에서 한 일을 돌아봅니다.

장	남은 것
03	AI는 다음 낱말을 고르는 기계다. 그래서 지어낸다. 공책에는 끝이 있다
04	웹은 말해주고, Claude Code는 해준다
05	결과물 하나(자기소개 페이지). HTML·마크다운
06	한 번에 뽑는 건 20분. 고치는 게 본론이다
07	두 번 말할 건 파일에 적는다

여기까지가 도구를 손에 익히는 단계였습니다.

2부부터는 달라집니다. 남이 만들어 둔 절차를 가져다 쓰는 법을 배웁니다. 품의서 하나를 55분에서 7분으로 줄인 그 물건입니다.

그리고 3부에서, 그걸 직접 만듭니다.