# 꽃집 연습 폴더로 배우는 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처럼 대화만 되는 곳에서 할 때. 내가 손으로 하고, 결과를 대화창에 붙여넣어요.

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

## 시작 전에 확인할 것

1. PC는 Windows인가요, Mac인가요?
2. 터미널이나 Claude Code를 써 본 적이 있나요? (처음 / 몇 번 / 자주)
3. 지금 어디서 하고 있나요? (Claude Code / claude.ai)
4. 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가 자동으로 듣지 않아요. 그래도 규칙 종이의 힘은 같은 방법으로 볼 수 있어요. 파일을 다루는 부탁은 여기서 시험할 수 없어서, 글 쓰는 규칙으로 해요.

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

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

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