바이브클래스 · 북노트
🗺️ 제작 마스터 가이드
내 진행률
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 booknote → claude 두 줄만 입력하면 언제든 이어서 작업할 수 있어요.

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