프롬프트를 복사해 붙여넣으면,
나만의 독서 기록 웹사이트가 완성됩니다
이 가이드 하나로 설치 → 화면 만들기 → 책 기록 → 회원가입 → 사진 업로드 → 댓글·좋아요 → 디자인 → 인터넷 공개까지, 강의에서 만든 북노트를 내 PC에서 그대로 완성할 수 있어요. 코딩은 한 줄도 하지 않습니다.
준비 — Claude Code 설치와 로그인
📼 강의 섹션 2 (레슨 4~11) · 소요 약 20분 · 최초 1회만 하면 됩니다
Claude Code는 내 컴퓨터 안에서 일해 주는 AI 직원이에요. 먼저 직원을 채용(설치)하고 출입증(로그인)을 만들어 줍니다. Claude 유료 구독(Pro 이상) 계정이 필요해요.
PowerShell 열기
레슨 6- 키보드에서 ⊞ Win 키를 누르고 powershell 이라고 입력해요.
- 검색 결과의 Windows PowerShell을 클릭해 실행해요.
- 파란(또는 검은) 창에 글자가 깜빡이면 성공 — 이 창이 앞으로 우리의 작업 창구예요.
설치 명령 한 줄 붙여넣기
레슨 7아래 한 줄을 복사해 PowerShell에 붙여넣고 Enter. 글자가 주르륵 올라가다 멈추면 설치 끝이에요.
irm https://claude.ai/install.ps1 | iex
winget install Anthropic.ClaudeCode 를 대신 붙여넣어 보세요. (레슨 11)새 창을 열고 설치 확인하기
레슨 8~9중요: 지금 열린 PowerShell 창을 닫고, 새로 하나 다시 열어서 아래를 붙여넣으세요. (새 프로그램은 새 창에서만 인식돼요)
claude --version
2.x.x 같은 버전 숫자가 나오면 설치 성공. 문제 없었다면 바로 아래 미션은 체크만 하고 건너뛰세요.[필요할 때만] claude를 못 찾아요 — 환경변수(PATH) 설정
레슨 9컴퓨터는 PATH라는 "프로그램 위치 안내판"을 보고 명령을 찾아요. 안내판에 Claude의 위치가 아직 안 적혀 있으면 "인식되지 않습니다"라고 나옵니다. 아래 순서대로 하나씩 해 보세요 — 열에 여덟은 ①에서 끝나요.
- 새 창 열기 — 열려 있는 PowerShell을 ✕로 완전히 닫고, 새로 열어
claude --version을 다시 입력해요. (새로 적힌 안내판은 새 창부터 읽어요) - 설치 폴더 확인 — 파일 탐색기 주소창에
%USERPROFILE%\.local\bin을 붙여넣고 Enter. 폴더 안에 claude.exe가 보이면 설치는 정상이에요. 폴더가 비어 있다면 위 미션의 설치 명령 한 줄을 다시 실행하세요. - 환경변수에 위치 등록 — claude.exe는 있는데 여전히 못 찾는다면, 아래 한 줄로 안내판에 위치를 직접 적어 줍니다.
%USERPROFILE%\.local\bin 을 붙여넣었을 때 claude.exe가 보이면 설치는 정상이에요.[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path","User") + ";$env:USERPROFILE\.local\bin", "User")길어 보여도 뜻은 하나예요 — "내 계정 안내판(Path)에 Claude가 사는 폴더 주소를 한 줄 추가해줘."
마우스로 하는 방법(같은 일이에요): ⊞ Win 키 → 환경 변수 검색 → 계정의 환경 변수 편집 클릭 → 위쪽 목록에서 Path 선택 → 편집 → 새로 만들기 → %USERPROFILE%\.local\bin 붙여넣기 → 확인을 눌러 창을 모두 닫아요.
- 등록이 끝나면 PowerShell 창을 완전히 닫고 새로 열어요. (안내판은 새 창부터 적용돼요)
- 새 창에서
claude --version을 다시 입력해요. - 그래도 안 되면 마지막 카드 — PC를 '다시 시작'(종료 아님) 한 뒤 한 번 더 확인해요.
첫 실행과 브라우저 로그인
레슨 10claude
- 처음 실행하면 브라우저가 열리며 로그인 화면이 나와요. 구독 중인 Claude 계정으로 로그인해요.
- "인증 완료" 화면이 보이면 PowerShell 창으로 돌아와요.
- 이제 ❯ 표시 옆에 우리말로 부탁을 적을 수 있어요. 인사 한번 해 볼까요.
안녕하세요, 앞으로 북노트(독서 기록장)를 같이 만들 거예요. 잘 부탁해요.
프로젝트 시작 — 폴더 · 규칙 · 첫 화면
📼 강의 섹션 3~4 (레슨 12~20) · 소요 약 40분
집을 짓기 전에 땅(폴더)을 정하고, 시공사에게 요구사항(규칙)을 문서로 남기고, 뼈대(첫 화면)를 올리는 단계예요.
북노트 전용 폴더 만들고 들어가기
레슨 17Claude가 실행 중이라면 Ctrl+C 를 눌러 잠시 빠져나오세요. 폴더를 만드는 방법은 두 가지 — 편한 쪽을 고르면 됩니다.
방법 ① 탐색기에서 만들기 (마우스만으로 OK)
파일 탐색기를 열어 문서 폴더 안에 새 폴더 booknote 를 미리 만들고, 그 폴더를 더블클릭해 들어갑니다. 폴더 안 빈 곳에서 마우스 오른쪽 버튼 → 터미널에서 열기(Windows 11) 또는 Shift+오른쪽 클릭 → 여기에 PowerShell 창 열기(Windows 10)를 누르면, PowerShell이 그 폴더 위치에서 바로 열려요. 이 경우 아래 ①·② 명령은 건너뛰고 ③ claude 만 입력하면 됩니다.
방법 ② 명령어로 만들기 — mkdir booknote 이렇게 명령으로 폴더를 만들 수도 있어요. 아래를 한 줄씩 붙여넣으세요.
mkdir booknote
cd booknote
claude
booknote 라는 폴더 이름이 보인 채로 Claude의 ❯ 입력줄이 뜨면 성공. 앞으로 모든 작업은 반드시 이 폴더 안에서 합니다.cd booknote → claude 두 줄만 입력하면 언제든 이어서 작업할 수 있어요.프로젝트 규칙 심어주기 (CLAUDE.md)
레슨 19Claude에게 "우리 프로젝트 수첩"을 만들게 하는 단계예요. 먼저 아래 명령을 입력하고,
/init
끝나면 이어서 우리 프로젝트만의 규칙을 적어 줍니다. 이 규칙 덕분에 앞으로 모든 결과물이 한결같이 나와요.
CLAUDE.md에 아래 규칙을 추가해줘. - 이 프로젝트는 '북노트'라는 독서 기록 웹앱이야. 만드는 사람은 코딩을 전혀 모르는 초보자야. - 설명은 항상 쉬운 한국어로, 전문 용어 없이 해줘. - 화면 글씨는 크고 또렷하게, 버튼은 큼직하게 만들어줘. - 디자인은 따뜻하고 차분한 톤을 유지해줘. - 무언가를 만들기 전에, 무엇을 할지 한두 문장으로 먼저 알려줘.
첫 화면 뼈대 만들기 — 책 목록 + 상세
레슨 18·20드디어 첫 결과물! "살펴보기 → 계획 → 만들기" 순서로 부탁하는 습관을 여기서부터 들여요.
북노트라는 독서 기록 웹앱을 만들 거야. 첫 화면(책 목록)과 책 상세 화면의 기본 틀이 필요해. 어떻게 만들지 계획을 먼저 쉬운 말로 알려줘. 아직 만들지는 마.
계획이 마음에 들면 승인해요. (마음에 안 드는 부분은 우리말로 고쳐 달라고 하면 돼요)
좋아, 그 계획대로 만들어줘. 첫 화면 위쪽에는 '나의 북노트'라는 제목을 크게 넣고, 아직 책이 없을 때는 '첫 책을 기록해 보세요'라는 안내 문구가 보이게 해줘. 다 만들면 브라우저에서 확인하는 방법을 알려줘.
첫 책을 기록해 보세요 ✍️
책 기록의 4가지 기능 — 저장·보기·수정·삭제
📼 강의 섹션 5 (레슨 21~26) · 소요 약 1시간
데이터베이스는 엑셀 표 한 장이라고 생각하면 돼요. 책 한 권 = 표의 한 줄. 이번 STEP에서 그 표에 넣고(저장), 꺼내 보고(목록), 고치고(수정), 지우는(삭제) 네 가지 기능을 완성합니다. 세상 모든 앱의 뼈대가 바로 이 네 가지예요.
책 저장하기 — 입력 폼 만들기
레슨 21~22책을 기록하는 입력 폼을 만들어줘. - 입력 칸: 제목, 저자, 별점, 한줄평 네 가지 - 별점은 별 5개 중에서 마음에 드는 별을 눌러 정하는 방식으로 - 저장 버튼을 누르면 데이터베이스에 저장되고 '저장했어요' 안내가 잠깐 보이게 - 첫 화면에 '+ 책 기록' 버튼을 달고, 누르면 이 폼이 열리게 해줘
저장한 책을 목록으로 보기
레슨 23저장한 책들을 첫 화면에 목록으로 보여줘. - 책마다 제목, 저자, 별점, 한줄평이 카드처럼 보기 좋게 - 최근에 기록한 책이 맨 위에 오게 - 새 책을 저장하면 새로고침 없이 목록에 바로 나타나게 해줘
책 정보 수정하기
레슨 24책을 수정하는 기능을 만들어줘. - 목록의 책마다 '수정' 버튼을 달아줘 - 수정을 누르면 원래 적었던 제목·저자·별점·한줄평이 그대로 채워진 폼이 열리게 해줘 - 고치고 저장하면 목록에 바뀐 내용이 바로 반영되게 해줘
수정 폼에 원래 별점하고 한줄평이 미리 채워지게 다시 해줘책 삭제하기 — 실수 방지 확인창
레슨 25책 목록에 책마다 '삭제' 버튼을 달아줘. 삭제를 누르면 '정말 삭제할까요? 되돌릴 수 없어요.' 확인창이 먼저 뜨고, 확인을 누른 책만 목록에서 사라지게 해줘. 취소를 누르면 아무 일도 일어나지 않게 해줘.
[응용] 읽는 중 / 완독 상태 배지 달기
레슨 26지금까지 배운 것을 스스로 조합해 보는 첫 응용 미션! 먼저 현재 상태를 물어보고 시작하면 좋아요.
지금 책은 어떤 정보들을 저장하고 있어? 쉬운 말로 알려줘.
책마다 '읽는 중 / 완독' 상태를 고를 수 있게 해줘. - 책을 기록하거나 수정할 때 두 상태 중 하나를 선택할 수 있게 - 책 목록에서 제목 옆에 작은 배지로 상태가 보이게 (읽는 중=주황, 완독=초록) - 선택한 상태는 새로고침해도 남도록 데이터베이스에 저장해줘
회원가입과 로그인 — 내 책장은 나만
📼 강의 섹션 6 (레슨 27~31) · 소요 약 1시간
지금은 누가 들어와도 같은 책장이 보여요. 회원 기능을 넣으면 "이 책은 누구의 기록"인지 구분되고, 내 기록은 나만 고칠 수 있게 됩니다.
회원가입 화면 만들기
레슨 27~28이메일과 비밀번호로 회원가입하는 화면을 만들어줘. - 입력 칸: 이메일, 비밀번호, 그리고 화면에 표시될 이름(닉네임) - 비밀번호는 6자 이상만 통과되게 하고, 짧으면 쉬운 한국어로 안내해줘 - 가입이 끝나면 '가입을 환영해요!' 인사와 함께 첫 화면으로 이동하게 해줘 - 오류가 나면 어려운 영어 메시지 대신 쉬운 한국어 안내가 뜨게 해줘
가입이 안 되는데 확인해줘. 화면에 뜬 메시지는 이거야: (오류 문구 붙여넣기)로그인 · 로그아웃 만들기
레슨 29로그인과 로그아웃을 만들어줘. - 로그인 화면에서 이메일·비밀번호로 로그인하면 화면 오른쪽 위에 내 이름이 보이게 해줘 - 이름 옆에 로그아웃 버튼을 두고, 누르면 처음 화면으로 돌아가게 해줘 - 로그인하지 않은 사람에게는 오른쪽 위에 '로그인' 버튼이 보이게 해줘 - 비밀번호가 틀리면 '비밀번호를 다시 확인해 주세요'라고 한국어로 알려줘
권한 걸기 — 내 책만 수정·삭제
레슨 30책마다 누가 기록했는지 저장하고, 권한을 걸어줘. - 로그인한 본인이 기록한 책에만 수정·삭제 버튼이 보이게 해줘 - 다른 사람의 책에는 수정·삭제 버튼이 아예 안 보이게 해줘 - 화면에서만 숨기는 게 아니라, 서버 쪽에서도 남의 기록은 절대 고칠 수 없게 막아줘 - 로그인해야만 새 책을 기록할 수 있게 해줘
지금은 남의 책에도 수정 버튼이 보여. 본인 책에만 보이게 다시 고쳐줘.[응용] '내 책장' 페이지 만들기
레슨 31'내 책장'이라는 페이지를 만들어줘. - 위쪽 메뉴에 '내 책장' 버튼을 추가하고, 로그인한 사람에게만 보이게 해줘 - 이 페이지에는 지금 로그인한 사람이 직접 기록한 책만 모아서 보여줘 - 다른 사람의 책은 절대 안 보이게 해줘 - 맨 위에 '○○님의 책장 · 총 N권'처럼 이름과 권수를 보여줘
표지 사진 올리기 — 책장이 살아나요
📼 강의 섹션 7 (레슨 32~34) · 소요 약 30분
글자만 있던 책장에 표지 사진이 붙는 순간, 진짜 서재 같아집니다. 사진 업로드는 "내 컴퓨터의 사진을 서버 창고에 맡기고, 보관증(주소)을 받아 책에 붙이는 일"이에요.
표지 사진 업로드 기능
레슨 32~33책을 기록하거나 수정할 때 표지 사진을 올릴 수 있게 해줘. - 폼에 '표지 사진 올리기' 버튼을 두고, 누르면 내 컴퓨터에서 사진을 고를 수 있게 - 사진을 고르면 폼 안에서 미리보기가 바로 보이게 해줘 - 저장하면 책 목록 카드에 표지가 세로 책 비율로 예쁘게 보이게 해줘 - 너무 큰 사진은 자동으로 알맞게 줄여서 올라가게 해줘
표지 없는 책은 기본 이미지로
레슨 34표지를 안 올린 책은 깨진 그림 대신 기본 이미지를 보여줘. - 깔끔한 책 모양 아이콘에 은은한 배경색을 깐 기본 표지로 해줘 - 기본 표지 위에 책 제목의 첫 두 글자가 보이면 더 좋아 - 예전에 표지 없이 저장한 책들에도 똑같이 적용해줘
함께 쓰는 북노트 — 둘러보기 · 댓글 · 좋아요 · 실시간
📼 강의 섹션 8 (레슨 35~39) · 소요 약 1시간 20분
혼자 쓰는 기록장을 넘어, 서로의 책 기록을 구경하고 응원하는 공간으로 키우는 단계예요. 요즘 SNS의 핵심 기능들이 전부 이 STEP에 있습니다.
둘러보기 페이지 — 모두의 기록 구경
레슨 35'둘러보기' 페이지를 만들어줘. - 위쪽 메뉴에 '둘러보기' 버튼을 추가해줘 - 모든 사람의 책 기록을 최신순으로 모아 보여줘 - 카드마다 표지, 제목, 별점, 한줄평, 그리고 기록한 사람 이름이 보이게 해줘 - 로그인 안 한 사람도 구경은 할 수 있게 해줘 (기록은 로그인해야만)
댓글 남기기
레슨 36책 기록 아래에 댓글 기능을 만들어줘. - 댓글 입력칸과 등록 버튼을 두고, 등록하면 새로고침 없이 바로 목록에 보이게 해줘 - 댓글마다 작성자 이름과 몇 분 전에 썼는지 함께 보여줘 - 내가 쓴 댓글에만 삭제 버튼이 보이게 해줘 - 빈 댓글은 등록되지 않게 하고, '내용을 입력해 주세요'라고 안내해줘
좋아요 하트 달기
레슨 37책마다 좋아요(하트) 버튼과 좋아요 수를 만들어줘. - 하트를 누르면 빨갛게 채워지며 숫자가 1 올라가고, 다시 누르면 취소돼서 1 내려가게 해줘 - 한 사람이 같은 책에 좋아요를 두 번 이상 누를 수 없게 해줘 - 로그인 안 한 사람이 하트를 누르면 '로그인이 필요해요' 안내가 뜨게 해줘
실시간으로 반영되게 하기
레슨 38브라우저 창을 두 개 나란히 열어 놓고 테스트하면 마법 같은 순간을 볼 수 있어요.
댓글과 좋아요가 실시간으로 보이게 해줘. 다른 사람이 댓글을 달거나 좋아요를 누르면, 내가 새로고침하지 않아도 내 화면에 몇 초 안에 자동으로 나타나게 해줘.
왼쪽에서 댓글을 달아도 오른쪽 창에 새로고침해야만 보여. 실시간으로 안 떠. 원인을 찾아서 고쳐줘.[응용] 알림 빨간 점 붙이기
레슨 39알림 기능을 만들어줘. - 위쪽 메뉴에 종 모양 아이콘을 추가해줘 - 내 책 기록에 다른 사람이 댓글이나 좋아요를 남기면 종에 빨간 점이 뜨게 해줘 - 종을 누르면 '누가 무엇을 했는지' 목록이 보이고, 빨간 점은 사라지게 해줘
예쁘게 다듬기 — 디자인과 반응형
📼 강의 섹션 9 (레슨 40~42) · 소요 약 40분
기능은 다 됐으니 이제 옷을 입힐 차례예요. 디자인도 우리말 한 문장이면 됩니다. 느낌을 형용사로 말해 주는 게 요령이에요.
전체 디자인 입히기
레슨 40북노트 전체를 따뜻하고 깔끔한 느낌으로 예쁘게 만들어줘. - 카드형 디자인에 부드러운 그림자와 둥근 모서리 - 포인트 색은 주황 계열 하나만 써서 통일감 있게 - 글씨는 40~50대가 읽기 편하게 충분히 크고 또렷하게 - 버튼은 큼직하게, 눌렀을 때 살짝 반응이 느껴지게 - 화면마다 스타일이 들쭉날쭉하지 않게 전체를 통일해줘
좀 더 차분하고 읽기 편하게 되돌려줘 · 취향을 더하고 싶으면: 포인트 색을 초록색으로 바꾸고, 제목을 '영희의 책장'으로 바꿔줘 (레슨 42)휴대폰에서도 잘 보이게 (반응형)
레슨 41휴대폰 화면에서도 안 깨지고 보기 좋게 만들어줘. - 좁은 화면에서는 책 카드가 한 줄에 하나씩 세로로 쌓이게 - 위쪽 메뉴는 좁은 화면에서 간단하게 접히게 - 버튼과 입력칸은 손가락으로 누르기 편한 크기로 - 책 제목이 길어도 잘리지 않고 다 보이게 해줘
인터넷에 공개하기 — GitHub와 Vercel
📼 강의 섹션 10 (레슨 43~45) · 소요 약 40분
지금까지 북노트는 내 컴퓨터 안에서만 열렸어요. 배포는 "내 작업물을 24시간 켜져 있는 인터넷 컴퓨터에 올려놓는 일"이에요. 끝나면 진짜 인터넷 주소가 생겨서 누구에게나 링크로 자랑할 수 있습니다. GitHub(작업물 보관소)와 Vercel(무료 공개 서비스) 계정이 필요해요 — 없으면 Claude가 만드는 것부터 도와줍니다.
GitHub에 작업물 올리기
레슨 43~44이 북노트 프로젝트를 GitHub에 올려줘. GitHub 계정이 연결되어 있는지 먼저 확인하고, 안 되어 있으면 무엇을 해야 하는지 한 단계씩 쉬운 한국어로 안내해줘. 비밀번호나 열쇠(API 키) 같은 민감한 파일은 올라가지 않게 꼭 빼줘.
Vercel로 진짜 주소 만들기
레슨 45이 북노트를 Vercel로 무료 배포하고 싶어. 필요한 과정을 한 단계씩 안내하면서 같이 진행해줘. 배포에 필요한 설정값이 있으면 어디서 찾아 어떻게 넣는지도 알려줘. 끝나면 접속할 수 있는 인터넷 주소를 알려줘.
booknote-○○○.vercel.app 같은 주소를 휴대폰에서 열어 내 책장이 보이면 성공. 이 순간이 이 강의의 하이라이트입니다! 🎉배포했더니 화면이 비어서 떠. 빠진 설정값이 있는 것 같아. 한국어로 알려주고 고쳐줘.완성 점검 & 앞으로 더 키우기
📼 강의 섹션 11 (레슨 46) · 소요 약 20분
최종 점검 — 처음부터 끝까지 한 바퀴
레슨 46배포된 진짜 주소에서 아래를 순서대로 확인해 보세요.
- 새 이메일로 회원가입 → 환영 인사 확인
- 책 한 권 기록 (표지 사진 포함) → 목록에 표시 확인
- 별점 수정 → 반영 확인 · 삭제 → 확인창 확인
- 둘러보기에서 다른 계정 책 구경 → 남의 책엔 수정 버튼 없음 확인
- 댓글·좋아요 남기기 → 상대 계정 종에 빨간 점 확인
- 휴대폰으로 접속 → 화면 안 깨지는지 확인
[보너스] 검색 기능으로 첫 확장
레슨 46완성은 끝이 아니라 시작이에요. 원하는 기능을 우리말로 말하는 것 — 그게 여러분이 배운 전부이자 앞으로의 전부입니다.
책 목록 위쪽에 검색칸을 추가해줘. 제목이나 저자를 입력하면 입력하는 즉시 목록이 걸러지게 해줘. 검색 결과가 없으면 '찾는 책이 없어요'라고 보여줘.
더 키워 볼 아이디어: 월별 독서 통계 그래프 · 읽고 싶은 책 위시리스트 · 독서 목표(올해 30권) 달성률 · 책 정보 자동 불러오기… 전부 같은 방식으로 부탁하면 됩니다.
🎉 완주를 축하합니다!
배포된 북노트 주소를 가족과 친구에게 공유해 보세요.
그리고 다음 아이디어가 떠오르면 — 이제 만드는 방법을 아시잖아요.
막혔을 때 — 만능 프롬프트 4종
어디서 막히든 아래 네 가지로 대부분 해결됩니다. 당황하지 말고, 상황을 그대로 말하면 돼요. (레슨 4)
① 화면에 오류가 떴어요
오류 문구를 마우스로 긁어 복사한 뒤, 이렇게 붙여넣으세요.
화면에 이런 오류가 떴어. 원인을 쉬운 한국어로 설명하고 고쳐줘: (여기에 오류 문구 붙여넣기)
② 방금 바꾼 게 마음에 안 들어요
방금 바꾼 거 원래대로 되돌려줘.
③ 뭐가 어떻게 돼 있는지 모르겠어요
지금 이 프로젝트가 어떤 상태인지, 무엇이 완성됐고 무엇이 남았는지 쉬운 한국어로 정리해서 알려줘.
④ 되긴 되는데 내가 원한 것과 달라요
"틀렸어"보다 무엇이 어떻게 다른지를 말해 주는 게 요령이에요.
지금은 (지금 보이는 모습)인데, 나는 (원하는 모습)이면 좋겠어. 그렇게 바꿔줘.