바이브클래스 · 북노트
🗺️ 제작 마스터 가이드
내 진행률
0 / 0 완료
Claude Code로 만드는 북노트 · 통합 따라하기

프롬프트를 복사해 붙여넣으면,
나만의 독서 기록 웹사이트가 완성됩니다

이 가이드 하나로 설치 → 화면 만들기 → 책 기록 → 회원가입 → 사진 업로드 → 댓글·좋아요 → 디자인 → 인터넷 공개까지, 강의에서 만든 북노트를 내 PC에서 그대로 완성할 수 있어요. 코딩은 한 줄도 하지 않습니다.

⏱️ 전체 약 6~8시간 (나눠서 진행 추천) 🪟 Windows 기준 📼 강의 46개 레슨과 순서 동일
🎯 사용법: 위에서부터 순서대로, 각 미션의 주황 [복사] 버튼을 눌러 프롬프트를 복사한 뒤 Claude Code 창에 붙여넣기(Ctrl+V) → Enter 하면 됩니다. 끝난 미션은 체크박스를 눌러 표시하세요 — 진행률이 자동 저장돼서 다음에 이어서 할 수 있어요.
STEP 0–1준비 & 시작설치, 로그인, 프로젝트 폴더와 첫 화면
STEP 2책 기록저장·목록·수정·삭제 + 읽기 상태
STEP 3–4회원 & 사진가입·로그인·권한, 표지 업로드
STEP 5–6커뮤니티 & 디자인댓글·좋아요·실시간, 스타일링
STEP 7–8공개 & 완성GitHub·Vercel 배포, 점검과 확장
⚠️
순서를 지켜 주세요. 뒤의 미션은 앞의 미션 위에 쌓입니다. 특히 STEP 2(책 기록)를 건너뛰고 STEP 3(회원)으로 가면 Claude가 헷갈릴 수 있어요. 하루에 STEP 하나씩만 해도 충분합니다.
STEP 0

준비 — Claude Code 설치와 로그인

📼 강의 섹션 2 (레슨 4~11) · 소요 약 20분 · 최초 1회만 하면 됩니다

Claude Code는 내 컴퓨터 안에서 일해 주는 AI 직원이에요. 먼저 직원을 채용(설치)하고 출입증(로그인)을 만들어 줍니다. Claude 유료 구독(Pro 이상) 계정이 필요해요.

PowerShell 열기

레슨 6
  1. 키보드에서 ⊞ Win 키를 누르고 powershell 이라고 입력해요.
  2. 검색 결과의 Windows PowerShell을 클릭해 실행해요.
  3. 파란(또는 검은) 창에 글자가 깜빡이면 성공 — 이 창이 앞으로 우리의 작업 창구예요.
🔍 powershell|
🟦
Windows PowerShell앱 · 가장 정확한 검색 결과 — 이걸 클릭!
⊞ Win 키 → powershell 입력 → 맨 위 결과 클릭
🟦 Windows PowerShell
Windows PowerShell
Copyright (C) Microsoft Corporation.
PS C:\Users\me>
▲ 이런 창이 열리고 커서가 깜빡이면 준비 완료. 여기에 복사한 내용을 붙여넣으면 됩니다.
💡
무서워하지 않아도 돼요. 터미널은 "글자로 컴퓨터에게 부탁하는 창구"일 뿐이에요. 이 가이드에서 입력할 내용은 전부 복사·붙여넣기로 해결됩니다.

설치 명령 한 줄 붙여넣기

레슨 7

아래 한 줄을 복사해 PowerShell에 붙여넣고 Enter. 글자가 주르륵 올라가다 멈추면 설치 끝이에요.

🟦 PowerShell에 붙여넣기
irm https://claude.ai/install.ps1 | iex
🟦 Windows PowerShell
PS C:\Users\me> irm https://claude.ai/install.ps1 | iex
Downloading Claude Code...
████████████████████ 100%
✓ Claude Code installed successfully
▲ 글자가 주르륵 올라간 뒤 이렇게 멈추면 설치 끝. 경고 문구가 몇 줄 섞여 있어도 괜찮아요.
성공 확인: "installed" 또는 "설치 완료" 비슷한 문구가 보이면 됩니다.
💡
다른 방법도 있어요. 위 명령이 막히면 winget install Anthropic.ClaudeCode 를 대신 붙여넣어 보세요. (레슨 11)

새 창을 열고 설치 확인하기

레슨 8~9

중요: 지금 열린 PowerShell 창을 닫고, 새로 하나 다시 열어서 아래를 붙여넣으세요. (새 프로그램은 새 창에서만 인식돼요)

🟦 새 PowerShell에 붙여넣기
claude --version
🟦 Windows PowerShell
PS C:\Users\me> claude --version
2.1.39 (Claude Code)
─── 만약 이렇게 나온다면? ───
PS C:\Users\me> claude --version
claude : 'claude' 용어가 인식되지 않습니다
▲ 위처럼 버전 숫자가 나오면 성공 · 아래처럼 빨간 글씨가 나오면 다음 미션(환경변수)으로!
성공 확인: 2.x.x 같은 버전 숫자가 나오면 설치 성공. 문제 없었다면 바로 아래 미션은 체크만 하고 건너뛰세요.
⚠️
"claude를 찾을 수 없습니다 / 인식되지 않습니다"가 뜨면? 고장이 아니에요 — 프로그램은 깔렸는데 컴퓨터가 위치를 아직 못 외운 것뿐입니다. 바로 아래 미션(환경변수 설정)으로 해결하세요.

[필요할 때만] claude를 못 찾아요 — 환경변수(PATH) 설정

레슨 9

컴퓨터는 PATH라는 "프로그램 위치 안내판"을 보고 명령을 찾아요. 안내판에 Claude의 위치가 아직 안 적혀 있으면 "인식되지 않습니다"라고 나옵니다. 아래 순서대로 하나씩 해 보세요 — 열에 여덟은 ①에서 끝나요.

  1. 새 창 열기 — 열려 있는 PowerShell을 ✕로 완전히 닫고, 새로 열어 claude --version을 다시 입력해요. (새로 적힌 안내판은 새 창부터 읽어요)
  2. 설치 폴더 확인 — 파일 탐색기 주소창에 %USERPROFILE%\.local\bin 을 붙여넣고 Enter. 폴더 안에 claude.exe가 보이면 설치는 정상이에요. 폴더가 비어 있다면 위 미션의 설치 명령 한 줄을 다시 실행하세요.
  3. 환경변수에 위치 등록 — claude.exe는 있는데 여전히 못 찾는다면, 아래 한 줄로 안내판에 위치를 직접 적어 줍니다.
📁 bin
← → ↑ %USERPROFILE%\.local\bin 🔍
⚙️
claude.exe
▲ ② 확인 화면 — 탐색기 주소창에 %USERPROFILE%\.local\bin 을 붙여넣었을 때 claude.exe가 보이면 설치는 정상이에요.
🟦 PowerShell에 붙여넣기 — 안내판(PATH)에 위치 등록
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path","User") + ";$env:USERPROFILE\.local\bin", "User")

길어 보여도 뜻은 하나예요 — "내 계정 안내판(Path)에 Claude가 사는 폴더 주소를 한 줄 추가해줘."

마우스로 하는 방법(같은 일이에요): ⊞ Win 키 → 환경 변수 검색 → 계정의 환경 변수 편집 클릭 → 위쪽 목록에서 Path 선택 → 편집새로 만들기%USERPROFILE%\.local\bin 붙여넣기 → 확인을 눌러 창을 모두 닫아요.

🔍 환경 변수|
⚙️
계정의 환경 변수 편집제어판 · 가장 정확한 검색 결과 — 이걸 클릭!
▲ 마우스 방법 ①단계 — ⊞ Win 키를 누르고 환경 변수라고 검색해요.
⚙️ 환경 변수
me에 대한 사용자 변수(U)
OneDriveC:\Users\me\OneDrive
Path...;%USERPROFILE%\.local\bin
TEMPC:\Users\me\...\Temp
새로 만들기(N)...편집(E)...삭제(D)
▲ 마우스 방법 ②단계 — 위쪽 사용자 변수 목록에서 Path를 선택하고 편집새로 만들기 → 주소 붙여넣기 → 확인.
  1. 등록이 끝나면 PowerShell 창을 완전히 닫고 새로 열어요. (안내판은 새 창부터 적용돼요)
  2. 새 창에서 claude --version 을 다시 입력해요.
  3. 그래도 안 되면 마지막 카드 — PC를 '다시 시작'(종료 아님) 한 뒤 한 번 더 확인해요.
성공 확인: 새 창에서 버전 숫자가 나오면 해결 완료. 이 설정은 한 번만 해 두면 계속 유지됩니다.
💡
순서 요약: ① 새 창 → ② 설치 폴더 확인 → ③ 환경변수 등록 → ④ 재시작. 자세한 화면은 레슨 9 영상·별첨자료에 있어요.

첫 실행과 브라우저 로그인

레슨 10
🟦 PowerShell에 붙여넣기
claude
  1. 처음 실행하면 브라우저가 열리며 로그인 화면이 나와요. 구독 중인 Claude 계정으로 로그인해요.
  2. "인증 완료" 화면이 보이면 PowerShell 창으로 돌아와요.
  3. 이제 표시 옆에 우리말로 부탁을 적을 수 있어요. 인사 한번 해 볼까요.
💬 Claude에게 붙여넣기
안녕하세요, 앞으로 북노트(독서 기록장)를 같이 만들 거예요. 잘 부탁해요.
🟦 Windows PowerShell — claude
PS C:\Users\me> claude
브라우저에서 로그인을 완료해 주세요... ✓ 로그인 완료
안녕하세요, 앞으로 북노트(독서 기록장)를 같이 만들 거예요. 잘 부탁해요.
반가워요! 북노트 만들기, 차근차근 같이 해 봐요. 준비되면 말씀만 하세요.
표시 옆이 우리가 말을 거는 자리예요. 앞으로 주황 [복사] 버튼의 내용은 전부 여기에 붙여넣습니다.
성공 확인: Claude가 한국어로 반갑게 대답하면 준비 끝! 이제 진짜 제작을 시작합니다.
STEP 1

프로젝트 시작 — 폴더 · 규칙 · 첫 화면

📼 강의 섹션 3~4 (레슨 12~20) · 소요 약 40분

집을 짓기 전에 땅(폴더)을 정하고, 시공사에게 요구사항(규칙)을 문서로 남기고, 뼈대(첫 화면)를 올리는 단계예요.

북노트 전용 폴더 만들고 들어가기

레슨 17

Claude가 실행 중이라면 Ctrl+C 를 눌러 잠시 빠져나오세요. 폴더를 만드는 방법은 두 가지 — 편한 쪽을 고르면 됩니다.

방법 ① 탐색기에서 만들기 (마우스만으로 OK)
파일 탐색기를 열어 문서 폴더 안에 새 폴더 booknote 를 미리 만들고, 그 폴더를 더블클릭해 들어갑니다. 폴더 안 빈 곳에서 마우스 오른쪽 버튼터미널에서 열기(Windows 11) 또는 Shift+오른쪽 클릭 → 여기에 PowerShell 창 열기(Windows 10)를 누르면, PowerShell이 그 폴더 위치에서 바로 열려요. 이 경우 아래 ①·② 명령은 건너뛰고 ③ claude 만 입력하면 됩니다.

방법 ② 명령어로 만들기mkdir booknote 이렇게 명령으로 폴더를 만들 수도 있어요. 아래를 한 줄씩 붙여넣으세요.

🟦 PowerShell — ① 폴더 만들기
mkdir booknote
🟦 PowerShell — ② 폴더로 들어가기
cd booknote
🟦 PowerShell — ③ 그 안에서 Claude 실행
claude
🟦 Windows PowerShell
PS C:\Users\me> mkdir booknote
디렉터리: C:\Users\me\booknote 만들어짐
PS C:\Users\me> cd booknote
PS C:\Users\me\booknote> claude
✓ booknote 폴더에서 시작합니다 — 한국어로 편하게 부탁하세요.
▲ 주소가 C:\Users\me\booknote 로 바뀐 채 ❯ 가 뜨면 성공. 이 "현재 위치"가 우리 작업장입니다.
성공 확인: 창에 booknote 라는 폴더 이름이 보인 채로 Claude의 ❯ 입력줄이 뜨면 성공. 앞으로 모든 작업은 반드시 이 폴더 안에서 합니다.
💡
다음에 다시 시작할 땐? PowerShell을 열고 cd booknoteclaude 두 줄만 입력하면 언제든 이어서 작업할 수 있어요.

프로젝트 규칙 심어주기 (CLAUDE.md)

레슨 19

Claude에게 "우리 프로젝트 수첩"을 만들게 하는 단계예요. 먼저 아래 명령을 입력하고,

💬 Claude에게 붙여넣기 — ①
/init

끝나면 이어서 우리 프로젝트만의 규칙을 적어 줍니다. 이 규칙 덕분에 앞으로 모든 결과물이 한결같이 나와요.

💬 Claude에게 붙여넣기 — ②
CLAUDE.md에 아래 규칙을 추가해줘.

- 이 프로젝트는 '북노트'라는 독서 기록 웹앱이야. 만드는 사람은 코딩을 전혀 모르는 초보자야.
- 설명은 항상 쉬운 한국어로, 전문 용어 없이 해줘.
- 화면 글씨는 크고 또렷하게, 버튼은 큼직하게 만들어줘.
- 디자인은 따뜻하고 차분한 톤을 유지해줘.
- 무언가를 만들기 전에, 무엇을 할지 한두 문장으로 먼저 알려줘.
성공 확인: "CLAUDE.md에 규칙을 추가했습니다"라는 답이 오면 성공. 이제 Claude는 매번 이 수첩을 먼저 읽고 일합니다.

첫 화면 뼈대 만들기 — 책 목록 + 상세

레슨 18·20

드디어 첫 결과물! "살펴보기 → 계획 → 만들기" 순서로 부탁하는 습관을 여기서부터 들여요.

💬 Claude에게 붙여넣기 — ① 계획 먼저
북노트라는 독서 기록 웹앱을 만들 거야.
첫 화면(책 목록)과 책 상세 화면의 기본 틀이 필요해.
어떻게 만들지 계획을 먼저 쉬운 말로 알려줘. 아직 만들지는 마.

계획이 마음에 들면 승인해요. (마음에 안 드는 부분은 우리말로 고쳐 달라고 하면 돼요)

💬 Claude에게 붙여넣기 — ② 승인하고 만들기
좋아, 그 계획대로 만들어줘.
첫 화면 위쪽에는 '나의 북노트'라는 제목을 크게 넣고,
아직 책이 없을 때는 '첫 책을 기록해 보세요'라는 안내 문구가 보이게 해줘.
다 만들면 브라우저에서 확인하는 방법을 알려줘.
📘 북노트
🔒 localhost:3000
📘 나의 북노트+ 책 기록
아직 기록한 책이 없어요.
첫 책을 기록해 보세요 ✍️
▲ 이 정도 화면이 뜨면 성공이에요. 주소(localhost:3000)는 "아직 내 컴퓨터 안에서만 보이는 임시 주소"입니다.
성공 확인: Claude가 알려준 방법대로 브라우저를 열었을 때 '나의 북노트' 제목이 보이면 성공. 화면이 밋밋해도 괜찮아요 — 디자인은 STEP 6에서 예쁘게 만듭니다.
💡
Claude가 파일을 바꾸기 전에 "Yes / No"를 물어봐요. 내용을 읽어 보고 Enter(Yes)를 누르면 진행됩니다. 허락을 구하는 건 정상적인 안전장치예요. (레슨 15)
STEP 2

책 기록의 4가지 기능 — 저장·보기·수정·삭제

📼 강의 섹션 5 (레슨 21~26) · 소요 약 1시간

데이터베이스는 엑셀 표 한 장이라고 생각하면 돼요. 책 한 권 = 표의 한 줄. 이번 STEP에서 그 표에 넣고(저장), 꺼내 보고(목록), 고치고(수정), 지우는(삭제) 네 가지 기능을 완성합니다. 세상 모든 앱의 뼈대가 바로 이 네 가지예요.

책 저장하기 — 입력 폼 만들기

레슨 21~22
💬 Claude에게 붙여넣기
책을 기록하는 입력 폼을 만들어줘.
- 입력 칸: 제목, 저자, 별점, 한줄평 네 가지
- 별점은 별 5개 중에서 마음에 드는 별을 눌러 정하는 방식으로
- 저장 버튼을 누르면 데이터베이스에 저장되고 '저장했어요' 안내가 잠깐 보이게
- 첫 화면에 '+ 책 기록' 버튼을 달고, 누르면 이 폼이 열리게 해줘
성공 확인: 브라우저에서 + 책 기록을 눌러 네 칸을 채우고 저장했을 때 안내가 보이면 성공. 목록에 안 보여도 정상이에요 — 목록은 바로 다음 미션에서 만듭니다.

저장한 책을 목록으로 보기

레슨 23
💬 Claude에게 붙여넣기
저장한 책들을 첫 화면에 목록으로 보여줘.
- 책마다 제목, 저자, 별점, 한줄평이 카드처럼 보기 좋게
- 최근에 기록한 책이 맨 위에 오게
- 새 책을 저장하면 새로고침 없이 목록에 바로 나타나게 해줘
📘 북노트
🔒 localhost:3000
📘 나의 북노트+ 책 기록
📕
달러구트 꿈 백화점
이미예 · ★★★★☆ · "잠들기 전이 기다려진다"
📗
불편한 편의점
김호연 · ★★★★★ · "골목 하나가 통째로 따뜻해진다"
▲ 저장한 책들이 카드로 쌓이는 모습. 최근 기록한 책이 맨 위에 와요.
성공 확인: 아까 저장한 책이 첫 화면에 보이고, 새 책을 한 권 더 저장하면 목록에 바로 추가되면 성공.

책 정보 수정하기

레슨 24
💬 Claude에게 붙여넣기
책을 수정하는 기능을 만들어줘.
- 목록의 책마다 '수정' 버튼을 달아줘
- 수정을 누르면 원래 적었던 제목·저자·별점·한줄평이 그대로 채워진 폼이 열리게 해줘
- 고치고 저장하면 목록에 바뀐 내용이 바로 반영되게 해줘
성공 확인: 수정 버튼을 눌렀을 때 기존 내용이 미리 채워져 있고, 별점을 바꿔 저장하면 목록에 반영되면 성공.
⚠️
수정 폼이 텅 비어서 열린다면? 이렇게 다시 부탁하세요: 수정 폼에 원래 별점하고 한줄평이 미리 채워지게 다시 해줘

책 삭제하기 — 실수 방지 확인창

레슨 25
💬 Claude에게 붙여넣기
책 목록에 책마다 '삭제' 버튼을 달아줘.
삭제를 누르면 '정말 삭제할까요? 되돌릴 수 없어요.' 확인창이 먼저 뜨고,
확인을 누른 책만 목록에서 사라지게 해줘.
취소를 누르면 아무 일도 일어나지 않게 해줘.
성공 확인: 삭제 → 확인창 → 확인을 눌렀을 때만 사라지고, 취소하면 그대로 남으면 성공.

[응용] 읽는 중 / 완독 상태 배지 달기

레슨 26

지금까지 배운 것을 스스로 조합해 보는 첫 응용 미션! 먼저 현재 상태를 물어보고 시작하면 좋아요.

💬 Claude에게 붙여넣기 — ① 현황 파악
지금 책은 어떤 정보들을 저장하고 있어? 쉬운 말로 알려줘.
💬 Claude에게 붙여넣기 — ② 기능 추가
책마다 '읽는 중 / 완독' 상태를 고를 수 있게 해줘.
- 책을 기록하거나 수정할 때 두 상태 중 하나를 선택할 수 있게
- 책 목록에서 제목 옆에 작은 배지로 상태가 보이게 (읽는 중=주황, 완독=초록)
- 선택한 상태는 새로고침해도 남도록 데이터베이스에 저장해줘
📘 북노트
🔒 localhost:3000
📘 나의 북노트+ 책 기록
📕
달러구트 꿈 백화점 완독
이미예 · ★★★★☆
📗
불편한 편의점 읽는 중
김호연 · ★★★★★
▲ 완성 모습 — 제목 옆에 읽는 중(주황) / 완독(초록) 배지가 붙어요.
성공 확인: 상태를 고른 뒤 새로고침해도 배지가 그대로 남아 있으면 성공. 🎉 여기까지 왔다면 앱의 핵심 골격은 완성입니다!
STEP 3

회원가입과 로그인 — 내 책장은 나만

📼 강의 섹션 6 (레슨 27~31) · 소요 약 1시간

지금은 누가 들어와도 같은 책장이 보여요. 회원 기능을 넣으면 "이 책은 누구의 기록"인지 구분되고, 내 기록은 나만 고칠 수 있게 됩니다.

회원가입 화면 만들기

레슨 27~28
💬 Claude에게 붙여넣기
이메일과 비밀번호로 회원가입하는 화면을 만들어줘.
- 입력 칸: 이메일, 비밀번호, 그리고 화면에 표시될 이름(닉네임)
- 비밀번호는 6자 이상만 통과되게 하고, 짧으면 쉬운 한국어로 안내해줘
- 가입이 끝나면 '가입을 환영해요!' 인사와 함께 첫 화면으로 이동하게 해줘
- 오류가 나면 어려운 영어 메시지 대신 쉬운 한국어 안내가 뜨게 해줘
성공 확인: 내 이메일로 가입해 보고 환영 인사가 뜨면 성공. 테스트용으로 가족 이메일 하나 더 가입해 두면 다음 미션 확인이 편해요.
⚠️
가입이 안 될 때 만능 문장: 가입이 안 되는데 확인해줘. 화면에 뜬 메시지는 이거야: (오류 문구 붙여넣기)

로그인 · 로그아웃 만들기

레슨 29
💬 Claude에게 붙여넣기
로그인과 로그아웃을 만들어줘.
- 로그인 화면에서 이메일·비밀번호로 로그인하면 화면 오른쪽 위에 내 이름이 보이게 해줘
- 이름 옆에 로그아웃 버튼을 두고, 누르면 처음 화면으로 돌아가게 해줘
- 로그인하지 않은 사람에게는 오른쪽 위에 '로그인' 버튼이 보이게 해줘
- 비밀번호가 틀리면 '비밀번호를 다시 확인해 주세요'라고 한국어로 알려줘
📘 북노트
🔒 localhost:3000
📘 나의 북노트👤 영희님 로그아웃
📕
달러구트 꿈 백화점 완독
이미예 · ★★★★☆
▲ 로그인 후 모습 — 오른쪽 위에 내 이름로그아웃 버튼이 보이면 성공이에요.
성공 확인: 로그인하면 오른쪽 위에 내 이름, 로그아웃하면 로그인 버튼으로 바뀌면 성공.

권한 걸기 — 내 책만 수정·삭제

레슨 30
💬 Claude에게 붙여넣기
책마다 누가 기록했는지 저장하고, 권한을 걸어줘.
- 로그인한 본인이 기록한 책에만 수정·삭제 버튼이 보이게 해줘
- 다른 사람의 책에는 수정·삭제 버튼이 아예 안 보이게 해줘
- 화면에서만 숨기는 게 아니라, 서버 쪽에서도 남의 기록은 절대 고칠 수 없게 막아줘
- 로그인해야만 새 책을 기록할 수 있게 해줘
성공 확인: 두 계정으로 번갈아 로그인해 보세요. 상대 계정의 책에는 수정·삭제 버튼이 안 보이면 성공.
⚠️
남의 책에도 버튼이 보인다면: 지금은 남의 책에도 수정 버튼이 보여. 본인 책에만 보이게 다시 고쳐줘.

[응용] '내 책장' 페이지 만들기

레슨 31
💬 Claude에게 붙여넣기
'내 책장'이라는 페이지를 만들어줘.
- 위쪽 메뉴에 '내 책장' 버튼을 추가하고, 로그인한 사람에게만 보이게 해줘
- 이 페이지에는 지금 로그인한 사람이 직접 기록한 책만 모아서 보여줘
- 다른 사람의 책은 절대 안 보이게 해줘
- 맨 위에 '○○님의 책장 · 총 N권'처럼 이름과 권수를 보여줘
성공 확인: 내 계정으로는 내 책만, 가족 계정으로는 가족 책만 보이면 성공.
STEP 4

표지 사진 올리기 — 책장이 살아나요

📼 강의 섹션 7 (레슨 32~34) · 소요 약 30분

글자만 있던 책장에 표지 사진이 붙는 순간, 진짜 서재 같아집니다. 사진 업로드는 "내 컴퓨터의 사진을 서버 창고에 맡기고, 보관증(주소)을 받아 책에 붙이는 일"이에요.

표지 사진 업로드 기능

레슨 32~33
💬 Claude에게 붙여넣기
책을 기록하거나 수정할 때 표지 사진을 올릴 수 있게 해줘.
- 폼에 '표지 사진 올리기' 버튼을 두고, 누르면 내 컴퓨터에서 사진을 고를 수 있게
- 사진을 고르면 폼 안에서 미리보기가 바로 보이게 해줘
- 저장하면 책 목록 카드에 표지가 세로 책 비율로 예쁘게 보이게 해줘
- 너무 큰 사진은 자동으로 알맞게 줄여서 올라가게 해줘
성공 확인: 사진을 고르면 미리보기가 뜨고, 저장 후 목록 카드에 표지가 보이면 성공.

표지 없는 책은 기본 이미지로

레슨 34
💬 Claude에게 붙여넣기
표지를 안 올린 책은 깨진 그림 대신 기본 이미지를 보여줘.
- 깔끔한 책 모양 아이콘에 은은한 배경색을 깐 기본 표지로 해줘
- 기본 표지 위에 책 제목의 첫 두 글자가 보이면 더 좋아
- 예전에 표지 없이 저장한 책들에도 똑같이 적용해줘
성공 확인: 표지 없이 책을 저장해도 깨진 그림 없이 단정한 기본 표지가 보이면 성공.
STEP 5

함께 쓰는 북노트 — 둘러보기 · 댓글 · 좋아요 · 실시간

📼 강의 섹션 8 (레슨 35~39) · 소요 약 1시간 20분

혼자 쓰는 기록장을 넘어, 서로의 책 기록을 구경하고 응원하는 공간으로 키우는 단계예요. 요즘 SNS의 핵심 기능들이 전부 이 STEP에 있습니다.

둘러보기 페이지 — 모두의 기록 구경

레슨 35
💬 Claude에게 붙여넣기
'둘러보기' 페이지를 만들어줘.
- 위쪽 메뉴에 '둘러보기' 버튼을 추가해줘
- 모든 사람의 책 기록을 최신순으로 모아 보여줘
- 카드마다 표지, 제목, 별점, 한줄평, 그리고 기록한 사람 이름이 보이게 해줘
- 로그인 안 한 사람도 구경은 할 수 있게 해줘 (기록은 로그인해야만)
성공 확인: 두 계정의 책이 한 화면에 섞여 최신순으로 보이면 성공.

댓글 남기기

레슨 36
💬 Claude에게 붙여넣기
책 기록 아래에 댓글 기능을 만들어줘.
- 댓글 입력칸과 등록 버튼을 두고, 등록하면 새로고침 없이 바로 목록에 보이게 해줘
- 댓글마다 작성자 이름과 몇 분 전에 썼는지 함께 보여줘
- 내가 쓴 댓글에만 삭제 버튼이 보이게 해줘
- 빈 댓글은 등록되지 않게 하고, '내용을 입력해 주세요'라고 안내해줘
성공 확인: 등록을 누르면 새로고침 없이 댓글이 바로 나타나고, 남의 댓글에는 삭제 버튼이 없으면 성공.

좋아요 하트 달기

레슨 37
💬 Claude에게 붙여넣기
책마다 좋아요(하트) 버튼과 좋아요 수를 만들어줘.
- 하트를 누르면 빨갛게 채워지며 숫자가 1 올라가고, 다시 누르면 취소돼서 1 내려가게 해줘
- 한 사람이 같은 책에 좋아요를 두 번 이상 누를 수 없게 해줘
- 로그인 안 한 사람이 하트를 누르면 '로그인이 필요해요' 안내가 뜨게 해줘
성공 확인: 하트를 눌렀다 다시 눌렀다 하며 숫자가 정확히 오르내리면 성공.

실시간으로 반영되게 하기

레슨 38

브라우저 창을 두 개 나란히 열어 놓고 테스트하면 마법 같은 순간을 볼 수 있어요.

💬 Claude에게 붙여넣기
댓글과 좋아요가 실시간으로 보이게 해줘.
다른 사람이 댓글을 달거나 좋아요를 누르면,
내가 새로고침하지 않아도 내 화면에 몇 초 안에 자동으로 나타나게 해줘.
성공 확인: 왼쪽 창에서 댓글을 달면 오른쪽 창에 저절로 나타나면 성공.
⚠️
안 될 때 그대로 붙여넣기: 왼쪽에서 댓글을 달아도 오른쪽 창에 새로고침해야만 보여. 실시간으로 안 떠. 원인을 찾아서 고쳐줘.

[응용] 알림 빨간 점 붙이기

레슨 39
💬 Claude에게 붙여넣기
알림 기능을 만들어줘.
- 위쪽 메뉴에 종 모양 아이콘을 추가해줘
- 내 책 기록에 다른 사람이 댓글이나 좋아요를 남기면 종에 빨간 점이 뜨게 해줘
- 종을 누르면 '누가 무엇을 했는지' 목록이 보이고, 빨간 점은 사라지게 해줘
성공 확인: 가족 계정으로 내 책에 좋아요를 누른 뒤, 내 계정 화면의 종에 빨간 점이 뜨면 성공.
STEP 6

예쁘게 다듬기 — 디자인과 반응형

📼 강의 섹션 9 (레슨 40~42) · 소요 약 40분

기능은 다 됐으니 이제 옷을 입힐 차례예요. 디자인도 우리말 한 문장이면 됩니다. 느낌을 형용사로 말해 주는 게 요령이에요.

전체 디자인 입히기

레슨 40
💬 Claude에게 붙여넣기
북노트 전체를 따뜻하고 깔끔한 느낌으로 예쁘게 만들어줘.
- 카드형 디자인에 부드러운 그림자와 둥근 모서리
- 포인트 색은 주황 계열 하나만 써서 통일감 있게
- 글씨는 40~50대가 읽기 편하게 충분히 크고 또렷하게
- 버튼은 큼직하게, 눌렀을 때 살짝 반응이 느껴지게
- 화면마다 스타일이 들쭉날쭉하지 않게 전체를 통일해줘
성공 확인: 첫 화면·둘러보기·내 책장이 모두 같은 톤으로 단정해지면 성공.
💡
과하다 싶으면: 좀 더 차분하고 읽기 편하게 되돌려줘 · 취향을 더하고 싶으면: 포인트 색을 초록색으로 바꾸고, 제목을 '영희의 책장'으로 바꿔줘 (레슨 42)

휴대폰에서도 잘 보이게 (반응형)

레슨 41
💬 Claude에게 붙여넣기
휴대폰 화면에서도 안 깨지고 보기 좋게 만들어줘.
- 좁은 화면에서는 책 카드가 한 줄에 하나씩 세로로 쌓이게
- 위쪽 메뉴는 좁은 화면에서 간단하게 접히게
- 버튼과 입력칸은 손가락으로 누르기 편한 크기로
- 책 제목이 길어도 잘리지 않고 다 보이게 해줘
성공 확인: 브라우저 창을 손바닥만 하게 좁혀도 화면이 안 깨지면 성공. (배포 후엔 진짜 휴대폰으로 확인!)
STEP 7

인터넷에 공개하기 — GitHub와 Vercel

📼 강의 섹션 10 (레슨 43~45) · 소요 약 40분

지금까지 북노트는 내 컴퓨터 안에서만 열렸어요. 배포는 "내 작업물을 24시간 켜져 있는 인터넷 컴퓨터에 올려놓는 일"이에요. 끝나면 진짜 인터넷 주소가 생겨서 누구에게나 링크로 자랑할 수 있습니다. GitHub(작업물 보관소)와 Vercel(무료 공개 서비스) 계정이 필요해요 — 없으면 Claude가 만드는 것부터 도와줍니다.

GitHub에 작업물 올리기

레슨 43~44
💬 Claude에게 붙여넣기
이 북노트 프로젝트를 GitHub에 올려줘.
GitHub 계정이 연결되어 있는지 먼저 확인하고,
안 되어 있으면 무엇을 해야 하는지 한 단계씩 쉬운 한국어로 안내해줘.
비밀번호나 열쇠(API 키) 같은 민감한 파일은 올라가지 않게 꼭 빼줘.
성공 확인: Claude가 알려준 github.com 주소에 들어갔을 때 내 프로젝트 파일들이 보이면 성공.

Vercel로 진짜 주소 만들기

레슨 45
💬 Claude에게 붙여넣기
이 북노트를 Vercel로 무료 배포하고 싶어.
필요한 과정을 한 단계씩 안내하면서 같이 진행해줘.
배포에 필요한 설정값이 있으면 어디서 찾아 어떻게 넣는지도 알려줘.
끝나면 접속할 수 있는 인터넷 주소를 알려줘.
📘 북노트
🔒 booknote-younghee.vercel.app
📘 나의 북노트👤 영희님 로그아웃
📕
달러구트 꿈 백화점 완독
이미예 · ★★★★☆ · ❤️ 3 · 💬 2
📗
불편한 편의점 읽는 중
김호연 · ★★★★★ · ❤️ 5 · 💬 4
▲ 주소창을 보세요 — localhost가 아니라 진짜 인터넷 주소! 이제 누구나 이 주소로 내 북노트에 올 수 있어요.
성공 확인: booknote-○○○.vercel.app 같은 주소를 휴대폰에서 열어 내 책장이 보이면 성공. 이 순간이 이 강의의 하이라이트입니다! 🎉
⚠️
배포했는데 화면이 하얗게 비어 있다면? 대부분 설정값이 빠진 거예요. 그대로 붙여넣으세요: 배포했더니 화면이 비어서 떠. 빠진 설정값이 있는 것 같아. 한국어로 알려주고 고쳐줘.
STEP 8

완성 점검 & 앞으로 더 키우기

📼 강의 섹션 11 (레슨 46) · 소요 약 20분

최종 점검 — 처음부터 끝까지 한 바퀴

레슨 46

배포된 진짜 주소에서 아래를 순서대로 확인해 보세요.

  1. 새 이메일로 회원가입 → 환영 인사 확인
  2. 책 한 권 기록 (표지 사진 포함) → 목록에 표시 확인
  3. 별점 수정 → 반영 확인 · 삭제 → 확인창 확인
  4. 둘러보기에서 다른 계정 책 구경 → 남의 책엔 수정 버튼 없음 확인
  5. 댓글·좋아요 남기기 → 상대 계정 종에 빨간 점 확인
  6. 휴대폰으로 접속 → 화면 안 깨지는지 확인
여섯 개 모두 통과했다면 — 북노트 정식 완성입니다. 코딩 한 줄 없이 회원제 커뮤니티 웹서비스를 만들어 인터넷에 공개하셨어요.

[보너스] 검색 기능으로 첫 확장

레슨 46

완성은 끝이 아니라 시작이에요. 원하는 기능을 우리말로 말하는 것 — 그게 여러분이 배운 전부이자 앞으로의 전부입니다.

💬 Claude에게 붙여넣기
책 목록 위쪽에 검색칸을 추가해줘.
제목이나 저자를 입력하면 입력하는 즉시 목록이 걸러지게 해줘.
검색 결과가 없으면 '찾는 책이 없어요'라고 보여줘.

더 키워 볼 아이디어: 월별 독서 통계 그래프 · 읽고 싶은 책 위시리스트 · 독서 목표(올해 30권) 달성률 · 책 정보 자동 불러오기… 전부 같은 방식으로 부탁하면 됩니다.

🎉 완주를 축하합니다!

배포된 북노트 주소를 가족과 친구에게 공유해 보세요.
그리고 다음 아이디어가 떠오르면 — 이제 만드는 방법을 아시잖아요.

⛑ SOS

막혔을 때 — 만능 프롬프트 4종

어디서 막히든 아래 네 가지로 대부분 해결됩니다. 당황하지 말고, 상황을 그대로 말하면 돼요. (레슨 4)

① 화면에 오류가 떴어요

오류 문구를 마우스로 긁어 복사한 뒤, 이렇게 붙여넣으세요.

💬 Claude에게 붙여넣기
화면에 이런 오류가 떴어. 원인을 쉬운 한국어로 설명하고 고쳐줘:
(여기에 오류 문구 붙여넣기)

② 방금 바꾼 게 마음에 안 들어요

💬 Claude에게 붙여넣기
방금 바꾼 거 원래대로 되돌려줘.

③ 뭐가 어떻게 돼 있는지 모르겠어요

💬 Claude에게 붙여넣기
지금 이 프로젝트가 어떤 상태인지, 무엇이 완성됐고 무엇이 남았는지
쉬운 한국어로 정리해서 알려줘.

④ 되긴 되는데 내가 원한 것과 달라요

"틀렸어"보다 무엇이 어떻게 다른지를 말해 주는 게 요령이에요.

💬 Claude에게 붙여넣기
지금은 (지금 보이는 모습)인데, 나는 (원하는 모습)이면 좋겠어. 그렇게 바꿔줘.
💡
그래도 안 풀리면 해당 레슨의 강의 영상과 별첨자료를 다시 보세요. 미션마다 오른쪽 위에 적힌 레슨 번호가 이정표입니다.