이 책은 무엇을 약속하는가

0.1 먼저, 이 책이 생긴 이유

「월간클로드」 2기 강의는 4주 동안 이렇게 진행됩니다.

준비     같이 설치하기 (개강 전, 온라인 1시간)
1단계    작업 환경 만들고, 설계·시안까지
2단계    안드로이드 앱 만들기
3단계    배포하기 — 웹은 Vercel, 앱은 구글 플레이
4단계    웹을 인터넷에 올리기 — GitHub 창고와 Vercel 주소

매주 월요일 밤 9시. 방식은 내내 같습니다. 준비된 프롬프트를 붙여넣고, Claude와 말로 주고받으며, 그 자리에서 만듭니다.

그런데 두 시간 안에 뭔가를 끝까지 만들려면 설명은 건너뛸 수밖에 없습니다. 강의는 원래 그런 자리입니다. 그러면 이런 것이 남습니다.

“화면에 창이 하나 떴는데 그냥 ‘허용’ 눌렀어요. 그게 뭐였죠?”

“Node.js는 왜 깔았어요? 한 번도 안 열어봤는데.”

“개발자 계정을 왜 그렇게 미리 하라고 하셨어요?”

손은 움직였는데, 머릿속에 이름이 안 붙은 겁니다. 이 책은 그 빈자리를 채웁니다.

강의가 남긴 빈자리를 이 책이 채운다

강의에서 그냥 넘어간 자리마다, 이 책은 세 가지를 채웁니다.

②가 중요한 이유는 — 이름을 알아야 검색할 수 있기 때문입니다. “그 창”은 검색이 안 되지만 “권한 창”은 검색이 됩니다.

---

0.2 강의를 안 들으셨어도 됩니다

이 책은 2기 수강생을 위해 시작했지만, 강의를 안 들은 분도 읽을 수 있게 썼습니다. 실습 절차는 요약해서 실어 두었고, 무게는 설명 쪽에 두었습니다.

그리고 코딩을 한 번도 안 해보셨어도 됩니다. 이 책은 다음을 전부 모른다고 가정하고 씁니다.

• 프로그래밍 언어 문법 — HTML(에이치티엠엘)도, 자바스크립트도
• 터미널 (검은 화면에 글자 치는 그것)
• Git(깃)과 GitHub(깃허브)
• API(에이피아이)

전부 나오긴 나옵니다. 다만 나올 때마다 처음부터 설명합니다. “당연히 아시겠지만” 이라는 말은 이 책에 나오지 않습니다.

---

0.3 다 읽으면 무엇이 남는가

이 책의 약속은 한 문장입니다.

내 사이트는 인터넷에, 내 앱은 구글 플레이에.

손에 남는 것은 두 가지입니다.

그런데 이 책이 정말로 드리려는 것은 결과물이 아닙니다. Claude에게 “내 공방 소개 페이지 만들어줘” 라고 하면 20분이면 나옵니다. 그건 이 책 없이도 됩니다.

이 책이 드리는 것은 그 20분 바깥에 있는 두 가지입니다.

① 만든 것을 망가뜨리지 않고 고치는 법

AI가 만들어 준 사이트는 내가 짠 게 아니라서, 어디를 어떻게 고쳐야 할지 모릅니다. “수정해줘” 라고만 하면 AI는 처음에 왜 그렇게 만들었는지 모르고 자기 생각대로 고칩니다. 몇 번 반복하면 처음과 완전히 다른 사이트가 됩니다.

그래서 이 책은 무엇을 만들고 무엇을 안 만들기로 했는지, 무엇이 왜 바뀌었는지를 먼저 글로 남기게 합니다. 그 기록이 있으면 AI는 원래 생각에 맞춰 고칩니다. 한 번에 뽑는 건 시작이고, 값어치는 그다음 — 계속 고쳐 쓸 수 있게 하는 데 있습니다.

② Claude가 대신 해주지 못하는 구간 ⭐

이쪽이 훨씬 큽니다.

이건 말로 시켜서 끝나지 않습니다. 사람이 직접 가입하고, 직접 누르고, 직접 기다려야 합니다. 3단계가 강의의 본체인 이유이고, 이 책이 그 앞의 장들을 공들여 준비하는 이유입니다.

---

0.4 이 책이 약속하지 않는 것

기술 책은 보통 할 수 있는 것부터 말합니다. 이 책은 못 하는 것을 먼저 말합니다. 기대가 어긋난 채로 시작하면 중간에 책을 덮게 되기 때문입니다.

① 4주 안에 앱이 “정식 출시” 되지는 않습니다

가장 조심해서 말해야 하는 부분입니다. 정확한 약속은 “올리는 데까지” 입니다.

웹사이트는 조건이 없습니다. 주소를 받는 그날부터 누구나 들어올 수 있습니다. 앱은 다릅니다. 이 차이는 3단계에서 자세히 다룹니다.

② 아이폰 앱은 만들지 않습니다

안드로이드만 다룹니다. 애플 개발자 계정은 해마다 $99가 들고 심사도 까다롭습니다. 아이폰만 있는 분도 2단계 실습은 따라올 수 있지만, 스토어를 통해 설치하는 것은 안드로이드 폰에서만 됩니다.

③ 개발자가 되지는 않습니다

목표는 프로그래머가 아니라 AI에게 만들 것을 정확하게 시킬 줄 아는 사람입니다. 다른 직업입니다.

④ “말만 하면 다 되는” 마법은 없습니다

애매하게 시키면 애매한 결과가 나옵니다. 그래서 2기 1단계는 코드를 한 줄도 쓰지 않고 무엇을 만들지 · 무엇을 안 만들지 · 어떻게 생겼는지 정하는 데 두 시간을 통째로 씁니다.

⑤ AI는 틀립니다. 자주 틀립니다

없는 기능을 있다고 하고, 숫자를 그럴듯하게 지어냅니다. 왜 그런지는 3장에서 봅니다.

⑥ 돈이 듭니다

유료 도메인(내가게.com 같은 주소)은 쓰지 않습니다. 무료로 주는 ○○.vercel.app 주소로 진행합니다.

---

0.5 이 책에서 다루지 않는 것

분량 때문에 의도적으로 뺀 것들입니다.

결제·문자·지도를 뺀 것은 “어려워서” 가 아닙니다. 만들 수는 있지만, 오늘 당장 쓸 수 있게 되기까지 사람이 거쳐야 할 절차가 너무 많기 때문입니다. 1단계의 판단 기준 한 줄 — 사람 · 시간 · 신청 · 명단 네 가지로 설명되면 만들 수 있습니다.

---

0.6 이 책을 읽는 법

구성

순서대로 읽으세요

앞 장에서 만든 것을 뒷 장에서 계속 씁니다. 특히 2기는 1단계에서 정한 것으로 2단계에서 만들고, 3단계에서 올립니다. 한 단계를 건너뛰면 다음 단계에서 올릴 물건이 없습니다.

본문에 나오는 상자

「아래 문장을 Claude에 입력하세요.」 다음에 나오는 회색 칸의 문장은 Claude Code 입력칸에 그대로 넣습니다. 끝에 붙은 (참고 10-①) 은 강의 자료 제작prompt.md 의 같은 번호 단계입니다.

---

0.7 시작하기 전 준비물

4번은 이 책에서 유일하게 “미리” 해야 하는 일입니다. 신원 확인에 보통 하루, 서류가 어긋나면 2주까지 걸립니다. 3단계 당일에 계정이 없으면 그 회차를 통째로 놓칩니다.

5번은 지금 정하지 않으셔도 됩니다. 1단계에서 Claude가 물어봐 주면서 같이 정합니다.

---

0.8 마지막으로

2기 강의 사이트 FAQ에 이런 질문이 있습니다.

“코딩을 전혀 몰라도 따라갈 수 있나요?”

네. 코드는 Claude가 씁니다. 여러분은 무엇을 만들지 정하고, 마음에 안 드는 부분을 말로 고칩니다.

이 답은 사실입니다. 다만 한 가지가 빠져 있습니다. “무엇을 만들지 정하는 것”이 생각보다 어렵습니다. 그리고 “말로 고치는 것”에도 요령이 있습니다. 이 책의 대부분은 그 두 가지에 쓰입니다.

준비되셨으면, 1장에서 설치부터 시작합니다.

---