내 규칙을 기억시키기 (CLAUDE.md)

지금까지 "파일 하나로 유지해 줘"를 최소 두 번은 말했을 거예요. 따뜻한 빵집 같은 색 취향도 서로 다른 세션에 두 번 설명했고요. 번거롭죠? 새 세션의 에이전트는 매번 출근 첫날인 신입 같아요. 실력은 좋은데, 이 프로젝트의 사정은 하나도 몰라요.

이 문제는 규칙을 한 곳에 적어두면 풀려요. 지켜야 할 규칙, 기준, 내 취향을 한 번만 써두는 거죠. 에이전트에게도 그런 파일이 있어요. 이 강의 전체에서 효과가 가장 큰 파일, CLAUDE.md예요.

오늘 만들 것

나를 기억하는 프로젝트예요. 내 규칙을 한 번 적고, 에이전트를 재시작하고, 완전히 새로운 세션이 시키지 않아도 그 규칙을 따르는 걸 지켜보게 돼요.

준비물

first-kitchen 폴더
약 25분

따라 하기

1. 원리 이해하기 (허무할 만큼 단순해요)

CLAUDE.md는 폴더 안에 있는 평범한 텍스트 파일이에요. Claude Code가 그 폴더에서 세션을 시작하면 이 파일을 자동으로 가장 먼저 읽어요. 메커니즘은 이게 전부예요. 설정도 마법도 없어요. 새 세션이 시작할 때마다 자동으로 읽는, 프로젝트 첫머리의 메모인 셈이죠.

2. 내 규칙 받아 적게 하기

작업 공간을 열고 이렇게 요청하세요:

이 프로젝트에 CLAUDE.md 파일을 만들어 줘. 내 규칙은 이거야:

- 나는 초보자야. 뭔가 바꾸기 전에, 뭘 하려는 건지 평범한 말로
  한 문장으로 먼저 알려 줘.
- 이 사이트는 index.html 파일 하나로 유지해. 절대 쪼개지 마.
- 내 디자인 취향: [2강에서 답한 것 — 예: "따뜻하게, 빵집처럼,
  굵은 포인트 컬러 하나"]. 새로 만드는 건 여기에 맞춰 줘.
- 변경할 때마다 브라우저 새로고침하라고 알려 줘.

그다음 이 파일이 언제 읽히고 왜 중요한지 두 줄로 나한테
다시 설명해 줘.

두 줄짜리 설명을 읽어 보세요. 방금 1번에서 이야기한 내용이 거의 그대로 들려와야 해요.

3. 작동 증명하기 (재미있는 부분)

규칙은 낯선 사람이 따라야 진짜예요. 그러니 낯선 사람을 데려오죠. /exit을 입력한 뒤 claude로 새로 시작하세요. 새 세션, 백지 기억, 출근 첫날이에요. 이제 아무 맥락도 주지 않고 작은 걸 요청하세요:

페이지에 내가 읽고 있는 책 섹션을 추가해 줘.

자세히 지켜보세요. 먼저 한 문장으로 뭘 할지 알리고(규칙 1), 전부 index.html 안에서 처리하고(규칙 2), 따뜻하게 스타일링하고(규칙 3), 새로고침하라고 말해 줄 거예요(규칙 4). 이 세션에는 아무도 아무 말 하지 않았어요. 그 파일이 대신 말해 준 거예요.

4. 나만의 규칙 하나 추가하기

파일을 직접 손으로 고칠 필요는 없어요. 이것도 요청 한 번이면 돼요:

CLAUDE.md에 규칙 하나만 더 추가해 줘: [나만의 규칙 — 예: "내
페이지 어디에도 '심층적'이라는 단어를 쓰지 마" 또는 "나한테는
항상 한국어로 답해 줘"].

이제부터 같은 걸로 에이전트를 두 번 바로잡게 된다면, 그건 번거로움이 아니라 규칙이 자기 존재를 알리는 순간이에요. CLAUDE.md에 적어 두세요.

막혔을 때

새 세션이 규칙을 무시했어요 — 대개 규칙이 너무 많은 텍스트에 파묻힌 경우예요. CLAUDE.md는 짧고 직설적으로 유지하세요. 날카로운 규칙 열 개가 공손한 규칙 마흔 개를 이겨요. 이렇게 물어보는 것도 방법이에요. "CLAUDE.md를 다시 읽고, 방금 네가 한 일에 어떤 규칙이 적용되는지 말해 줘."
세션 도중에 CLAUDE.md를 고쳤는데 아무 일도 없어요 — 이 파일은 세션 시작 시점에 읽혀요. /exit 하고 claude. 새 세션이 새로 읽어요.
에이전트가 혼자서 거창한 CLAUDE.md를 써버렸어요 — 다듬으세요. "CLAUDE.md를 내가 실제로 준 규칙만 남게 줄여 줘." 내용이 부푼 파일은 에이전트가 매 세션 읽어야 하는 짐이에요. 짧게 유지하세요.

마무리 체크

나가기 전에 하나씩 확인해요:

□ CLAUDE.md가 존재하고, '나의' 규칙이 평범한 말로 담겨 있다
□ 새 세션이 시키지 않아도 규칙을 따랐다
□ 내가 직접 생각해낸 규칙을 최소 하나 추가했다
□ 반사신경이 생겼다: 두 번 바로잡았다? → CLAUDE.md로

다음 달의 세션들이 1년쯤 알고 지낸 사람과 일하는 느낌이 든다면, 그건 이 파일 덕분이에요. (이 아이디어를 더 깊이 파고 싶어지면, 통째로 다룬 글이 있어요: 카파시의 주방 노트.)

다음 레슨 — 05 되돌리기 안전장치 만들기 (git). 3강의 되돌리기는 에이전트의 짧은 기억에 기댔어요. 이제 진짜 영구적인 세이브 포인트를 설치할 시간이에요. 이 프로젝트에서 하는 어떤 일도 다시는 복구 불가능해지지 않도록요.

막힌 단계가 있나요? 아래 질문 상자에 남겨 주세요. 헤맨 단계가 있다면 그건 레슨에 난 구멍이지, 읽는 사람 잘못이 아니에요.