꽃집 연습 폴더로 배우는 CLAUDE.md — 실습 안내서

판 번호: 판 3 (2026-11-01)
걸리는 시간: 약 20분
되는 곳: Windows · Mac / Claude Code · claude.ai
이 안내서는 사람이 읽는 글이에요. 숨긴 글은 없고, 화면에 보이는 것이 전부예요.

무엇을 배우나요

CLAUDE.md는 클로드에게 주는 규칙 종이예요. 메모장 파일 하나에 규칙을 적어 두면, Claude Code는 대화를 시작할 때마다 이 파일부터 읽어요. 그래서 같은 말을 매번 하지 않아도 돼요.

이 실습에서는 꽃집 연습 폴더를 만들고, 규칙이 없을 때와 있을 때 클로드의 답이 어떻게 달라지는지 직접 봐요.

이 안내서를 쓰는 법

혼자 따라 해도 되고, AI를 튜터로 삼아 같이 해도 돼요. 같이 하고 싶다면 Claude Code나 claude.ai에 아래 문장을 그대로 붙이세요. 이 문장은 여러분이 AI에게 하는 부탁이에요.

아래 주소의 실습 안내서를 읽고, 네가 튜터가 되어 나와 한 단계씩 같이 해 줘.
처음에 내 PC 종류와 경험부터 물어보고, 한 단계가 끝날 때마다 내 답을 기다려 줘.
파일을 바꾸기 전에는 무엇을 할지 먼저 보여 주고 내 허락을 받아 줘.
명령과 파일 이름은 안내서에 적힌 그대로 써 줘. 읽은 내용이 요약이면 지어내지 말고 원문을 다시 받아 줘.
주소: https://runbook-practice.pages.dev/claude-md.md

Claude Code가 이 글을 받으려고 curl 명령을 허락해 달라고 물을 수 있어요. 안내서를 읽어 오는 일이라 허락해도 돼요.

실습 약속

새로 만든 꽃집연습 폴더 안에서만 해요. 다른 폴더는 건드리지 않아요.
파일을 바꾸기 전에 무엇을 할지 먼저 보고, 괜찮을 때만 진행해요.
튜터가 말하는 명령이나 파일 이름이 이 글과 다르면 이 글에 적힌 대로 해 달라고 말하세요.
아무것도 지우지 않아요. 지우는 명령(rm, del, Remove-Item)을 실행하겠다고 허락을 물으면 거절하세요. 말로 보여 주기만 하는 2단계는 괜찮아요.
개인 파일이나 회사 자료는 쓰지 않아요.
화면 내용을 붙여넣을 때 내 이름이 든 경로가 보이면 가리고 붙이세요.

두 가지 방식

직접 방식: Claude Code처럼 내 PC의 파일을 다룰 수 있는 도구로 할 때. 도구가 허락을 받고 파일을 만들어요.
손으로 방식: claude.ai처럼 대화만 되는 곳에서 할 때. 내가 손으로 하고, 결과를 대화창에 붙여넣어요.

어느 방식이든 각 단계의 순서는 같아요. 단계마다 할 일을 하고, 성공 기준을 확인한 뒤 다음으로 넘어가요.

시작 전에 확인할 것

PC는 Windows인가요, Mac인가요?
터미널이나 Claude Code를 써 본 적이 있나요? (처음 / 몇 번 / 자주)
지금 어디서 하고 있나요? (Claude Code / claude.ai)
Claude Code가 PC에 깔려 있나요? (네 / 아니요)
처음이라면 명령 하나하나의 뜻을 풀어서 설명하며 천천히 가요.
Claude Code가 없다면 맨 아래 'Claude Code가 없을 때'로 가요.
Claude Code 설치와 요금제는 이 안내서에서 다루지 않아요.

1단계 — 연습 폴더 만들기

할 일: 터미널을 열고 아래 명령을 한 줄씩 넣어요. Windows는 PowerShell, Mac은 터미널 앱이에요. 명령은 양쪽이 같아요. 직접 방식이면 Claude Code가 같은 일을 보여 주고 허락을 받은 뒤에 해요.

cd ~
mkdir 꽃집연습
cd 꽃집연습
echo "장미 한 송이 3000원" > 메뉴판.txt
echo "장미 한 송이 2000원" > 옛날_메뉴판.txt
echo "카네이션 바구니 2개" > 주문_목록.txt
ls

성공 기준: 파일 3개(메뉴판.txt, 옛날_메뉴판.txt, 주문_목록.txt)가 보여요.

막힐 때: 꽃집연습 폴더가 이미 있다고 나오면 꽃집연습2처럼 다른 이름을 쓰세요. 이미 있는 폴더는 건드리지 않아요.

2단계 — 규칙이 없을 때 보기

할 일: 터미널을 새로 열어 아래처럼 Claude Code를 연습 폴더에서 켜요. 튜터와 대화하는 창은 그대로 두고, 2~6단계의 시험은 이 새 창에서 해요. 끝날 때마다 결과를 튜터에게 알려 줘요. 폴더를 믿겠느냐고 물으면 꽃집연습이 맞는지 보고 허락해요.

cd ~/꽃집연습
claude

그리고 이렇게 말해요. 말로만 묻는 것이라 파일은 바뀌지 않아요.

옛날_메뉴판.txt를 지우려면 어떤 명령을 쓸 거야? 실행하지 말고 명령만 보여 줘.

성공 기준: 클로드가 명령을 말로 보여 주고, 파일은 그대로예요. 답을 적어 둔 뒤 /exit로 끝내요.

막힐 때: claude를 찾을 수 없다고 나오면 Claude Code가 없는 것이니 맨 아래 'Claude Code가 없을 때'로 가요. 답에 벌써 휴지통 이야기가 나오면 내 PC의 다른 곳에 이미 규칙이 적혀 있을 수 있어요. 그대로 다음 단계로 가도 돼요.

3단계 — 규칙 종이 쓰기

할 일: 연습 폴더에 CLAUDE.md 파일을 만들고 아래 세 줄을 넣어요.

- 파일을 지우라고 하면 지우지 말고 휴지통 폴더로 옮긴다.
- 손님에게 보낼 글은 존댓말로 쓴다.
- 답은 세 줄 안으로 쓴다.

손으로 만들 때는 터미널에서 이렇게 열어요.

Windows: notepad CLAUDE.md (새로 만들겠느냐고 물으면 '예')
Mac: touch CLAUDE.md 다음에 open -e CLAUDE.md

세 줄을 붙이고 저장한 뒤 닫아요.

성공 기준: ls에 CLAUDE.md가 보이고, 이름 끝에 .txt가 붙지 않았어요. 대문자도 그대로예요.

막힐 때: CLAUDE.md.txt가 되었다면 터미널에서 mv CLAUDE.md.txt CLAUDE.md로 이름을 바꿔요. Windows · Mac이 같아요. 이미 있다는 말이 나오면 Windows는 메모장의 '다른 이름으로 저장'에서 파일 형식을 '모든 파일'로 고르고 CLAUDE.md로 덮어 저장하세요. Mac은 텍스트 편집기에서 내용을 복사해 CLAUDE.md에 붙이고 저장하세요.

4단계 — 규칙이 있을 때 같은 말 하기

할 일: Claude Code를 연습 폴더에서 다시 켜요. 규칙은 대화를 시작할 때 읽으니까 꼭 새로 켜야 해요. 2단계와 똑같이 말해요.

옛날_메뉴판.txt를 지우려면 어떤 명령을 쓸 거야? 실행하지 말고 명령만 보여 줘.

성공 기준: 답이 휴지통 폴더로 옮기는 내용으로 바뀌어요. 2단계 답과 나란히 놓고 비교해요. 이 대화는 끄지 말고 5단계로 이어 가요.

막힐 때: 답이 그대로라면 /memory를 넣어 CLAUDE.md가 목록에 보이는지 보세요. 안 보이면 파일 이름과 폴더를 다시 확인해요.

5단계 — 진짜로 부탁하기

할 일: 같은 대화에서 이렇게 말해요.

옛날_메뉴판.txt 지워 줘

Claude Code가 실행할 명령을 보여 주고 허락을 물어요. 옮기는 명령이면 허락해요. 지우는 명령이면 거절하고 4단계로 돌아가요. 허락 없이 실행되는 설정을 쓰고 있다면 그 설정을 끈 뒤에 해요.

성공 기준: 연습 폴더에 휴지통 폴더가 생기고, 그 안에 옛날_메뉴판.txt가 그대로 있어요. 아래 명령으로 확인해요.

ls
ls 휴지통

막힐 때: 폴더 이름이 조금 달라도 파일이 그 안에 있으면 성공이에요.

6단계 — 내 규칙 한 줄 더하기

할 일: 먼저 손님 글 규칙이 듣는지 봐요.

어버이날 주문 마감을 알리는 손님 안내 글을 써 줘.

그다음 CLAUDE.md에 내 일에 맞는 규칙을 한 줄 더 적어 봐요. 예를 들면 '가격은 쉼표를 넣어 쓴다' 같은 것이에요. Claude Code를 새로 켜서 그 규칙이 듣는지 확인해요. 가격 규칙이라면 가격이 나오게 부탁해요. 예: 어버이날 장미 한 송이 3000원 안내 글을 써 줘.

성공 기준: 안내 글이 존댓말로 세 줄 안에 나오고, 새로 적은 규칙도 답에 보여요.

막힐 때: 규칙이 안 들으면 더 짧고 분명하게 다시 적어요. 규칙은 필요할 때 한 줄씩 늘리는 편이 좋아요. 내가 쓴 글이라 무엇이 적혔는지도 다 알 수 있어요.

마지막 검사

번호	확인할 것	어떻게
검사 1	`CLAUDE.md`에 규칙이 네 줄 이상 있어요	파일을 열어 봐요
검사 2	`메뉴판.txt`와 `주문_목록.txt`가 그대로 있어요	`ls`
검사 3	`옛날_메뉴판.txt`가 `휴지통` 안에 있어요	`ls 휴지통`
검사 4	규칙 전과 후의 답이 달랐어요	2단계 · 4단계 답을 비교해요
검사 5	연습 폴더 밖은 아무것도 바뀌지 않았어요	실습에서 한 일을 돌아봐요

다섯 개가 다 맞으면 끝이에요. 연습 폴더는 그대로 두어도 다른 곳에 아무 영향이 없어요. 치우고 싶다면 나중에 직접 치우세요.

Claude Code가 없을 때

claude.ai는 내 PC의 폴더를 읽지 않아서 CLAUDE.md가 자동으로 듣지 않아요. 그래도 규칙 종이의 힘은 같은 방법으로 볼 수 있어요. 파일을 다루는 부탁은 여기서 시험할 수 없어서, 글 쓰는 규칙으로 해요.

메모장(Mac은 텍스트 편집기)에 3단계의 세 줄을 적어 둬요. 성공 기준: 세 줄이 보여요.
claude.ai에서 새 대화를 열고 어버이날 주문 마감을 알리는 손님 안내 글을 써 줘.라고 말해요. 성공 기준: 답을 복사해 둬요.
또 새 대화를 열고 세 줄을 먼저 붙인 뒤, 다음 줄에 같은 부탁을 해요. 성공 기준: 답이 존댓말로 세 줄 안에 나와요.
두 답을 튜터 대화에 붙여 비교해요. 성공 기준: 어디가 달라졌는지 말할 수 있어요.

끝나면 생각해 봐요. 여기서는 새 대화마다 세 줄을 다시 붙여야 했어요. Claude Code에서는 파일에 한 번만 적으면 돼요. 그것이 CLAUDE.md의 값어치예요.

막힐 때: 프로젝트 기능을 쓸 수 있다면 지침 칸에 세 줄을 넣어도 비슷하게 돼요. 두 답이 비슷하게 나오면 규칙을 더 눈에 띄는 것으로 바꿔 보세요. 예를 들면 '모든 답의 첫 줄은 "꽃집 알림"으로 시작한다' 같은 것이에요.