# 15분 따라 하기

처음이시라면 이 문서 하나만 따라 해보세요. **한 번 끝까지 가보면 나머지는 응용입니다.**

만들 것은 "할 일 목록" 화면 하나예요. 진짜로 쓰려는 화면이 아니라, **말로 만들고 → 보고 → 고치는 리듬**을 몸에 익히는 게 목적입니다. 다 하면 지우면 돼요.

준비물은 터미널 하나와 15분입니다. 코딩 지식은 필요 없어요.

---

## 시작하기 전에

터미널에서 프로젝트 폴더로 들어가 Claude를 켭니다.

```bash
cd my-project
claude
```

`MCP servers found` 같은 물음이 나오면 **Enter로 켜주세요.** 화면을 자동으로 확인해주는 도구예요.

지금 화면에 뭐가 떠 있든 신경 쓰지 않아도 됩니다. 처음 보이는 건 **미리 담아둔 샘플**이고, 곧 여러분 화면으로 바뀝니다.

---

## 1단계 — 화면 하나 만들기 (약 10분)

대화창에 그대로 붙여넣으세요.

```
할 일 목록 화면을 만들어줘. 할 일을 추가할 수 있고, 완료 체크를 할 수 있으면 좋겠어.
```

### 이때 무슨 일이 일어나나요

Claude가 바로 코드를 짜지 않고 **먼저 정리해서 보여줍니다.**

> "이런 화면이 생겨요 → 거기서 이런 동작을 해요 → 이런 경우엔 이렇게 처리돼요"

맞으면 "응" 또는 "그렇게 해줘"라고 답하세요. 다르면 그 자리에서 말하면 됩니다 — **여기서 고치는 게 제일 쌉니다.**

합의가 되면 만들기 시작하고, 중간에 **진행 단계가 목록으로 보입니다.** 지금 어디쯤인지, 몇 단계 남았는지 알 수 있어요.

> **조용해 보여도 놀고 있는 게 아닙니다.** 화면을 만든 뒤 스스로 검사를 돌리는 시간이 있어요. 보통 10~15분이고, 큰 요청이면 더 걸립니다.

### 끝나면

브라우저가 열리고 Claude가 멈춥니다. **여기가 여러분 차례예요.**

---

## 2단계 — 고쳐보기 (약 2분)

화면을 보고 마음에 안 드는 걸 그냥 말하면 됩니다. 기술 용어는 필요 없어요.

```
버튼을 좀 더 크게 해줘
```

```
완료한 할 일은 회색으로 흐리게 보여줘
```

고치고 나면 다시 화면을 열어 보여주고 멈춥니다. **이 왕복이 이 도구의 기본 리듬**이에요. 마음에 들 때까지 반복하면 됩니다.

디자인을 통째로 바꾸고 싶으면 이렇게 말해도 됩니다:

```
전체적으로 더 밝고 둥근 느낌으로 바꿔줘
```

---

## 3단계 — 되돌려보기 (약 1분)

**이게 이 도구에서 제일 중요한 안전장치예요.** 한 번 해보고 넘어가세요.

일부러 마음에 안 들 만한 걸 시켜봅니다.

```
글씨를 아주 크게 키워줘
```

화면이 이상해졌죠? 이제 되돌립니다.

```
아까 상태로 되돌려줘
```

원래대로 돌아옵니다. **뭘 시켜도 되돌릴 수 있다**는 걸 알면 훨씬 편하게 쓸 수 있어요.

> 되돌리기가 되는 이유는 Claude가 매 단계 조용히 저장해 두기 때문입니다. 첫 저장 전에 한 번 물어볼 거예요.

---

## 4단계 — 저장되게 하기 (약 2분)

지금은 새로고침하면 할 일이 사라질 거예요. 남게 만듭니다.

```
새로고침해도 할 일이 남아 있게 해줘
```

Claude가 물어볼 수 있습니다 — **"이 데이터, 다른 사람도 같이 보나요? 본인 컴퓨터에서만 보이면 되나요?"** 지금은 "저만 보면 돼요"로 답하세요.

다 되면 새로고침해서 할 일이 남아 있는지 직접 확인해보세요.

---

## 5단계 — 인터넷에 올리기 (약 3분, 선택)

만든 걸 다른 사람에게 링크로 보여줄 수 있어요.

```
배포해줘
```

### 이때 확인할 것

Claude가 먼저 물어봅니다 — **"인터넷에 올리면 주소를 아는 사람은 누구나 볼 수 있어요. 지금 화면에 있는 데이터 그대로 올려도 괜찮을까요?"**

연습용이니 괜찮지만, **실제 회사 데이터나 개인정보가 있으면 여기서 "아니요"라고 하세요.** 이 질문은 매번 나옵니다.

올리기 전에 전체 검사가 한 번 돌아서 몇 분 걸립니다. 끝나면 주소를 줍니다.

---

## 여기까지 왔다면

이제 실제로 만들고 싶은 걸 시작하면 됩니다. 방금 한 리듬 그대로예요.

**한 가지만 기억하세요 — 잘 만들려면 요청을 잘 주면 됩니다.**

- 러프하게 "뭔가 만들어줘"보다, **기획서나 Jira 티켓 내용을 통째로 붙여넣는 게** 훨씬 잘 나옵니다.
- 한 번에 다 시키지 말고 **작게 쪼개세요.** "전체 다"보다 "목록 화면부터"가 빠릅니다.

막히면 그냥 물어보세요. `"에러 나"`, `"화면이 안 떠"`, `"무슨 뜻인지 쉽게 알려줘"` — 스스로 고치고 결과만 알려줍니다.

연습으로 만든 할 일 화면은 이제 지워도 됩니다:

```
아까 연습으로 만든 할 일 화면 지워줘
```

더 자세한 내용과 자주 묻는 질문은 [README](../README.md)에 있어요.
