AI로 내 홈페이지 만들기 · 치트시트

오늘 쓰는 말은 이게 전부예요. 복사 버튼을 누르고 터미널에 붙여넣기만 하세요. 집에서 다시 할 때도 이 순서 그대로.

오늘의 리듬 이것 하나만 기억하면 돼요

AI가 계획→AI가 질문→내가 승인→AI가 실행

규칙 3개

  1. 코드는 읽지 않아요. 화면만 보고 말해요.
  2. 모르면 "추천해줘". AI가 정하고 이유를 한 줄 말해줘요.
  3. 깨지면 "에러 고쳐줘". 원인은 AI가 찾아요.

하나 더: 고객 실명, 사진, 사례는 넣지 않아요. 공개되는 홈페이지예요.

Claude와 ChatGPT, 차이는 한 줄

AI를 켜는 명령만 달라요. Claude는 claude, ChatGPT는 codex. 아래 프롬프트는 둘 다 같아요. 끄는 건 둘 다 Ctrl+C 두 번.

0. 시작: 써 온 글 넣기

배우는 것: AI가 파일을 만든다. 내가 쓴 글이 폴더에 생긴다.

작업 폴더에서 claude(또는 codex)를 켠 다음:

지금 폴더에 vision.md 파일을 만들고, 아래 내용을 그대로 저장해줘. 저장만 하고 다른 건 아무것도 하지 마.

(여기에 써 온 내용 붙여넣기)

확인: 탐색기(Finder)에 vision.md가 생겼나 보기.

① 질문 받기

배우는 것: AI가 먼저 물어본다. 모르면 추천을 받는다.

vision.md를 읽어줘. 이걸 홈페이지로 만들 거야.
만들기 전에 네가 꼭 알아야 하는데 vision.md에 빠진 것만 질문해줘.
- 질문은 5개 이내, 번호를 붙여서 한 번에 보여줘.
- 기술적인 질문(어떤 도구, 어떤 코드)은 하지 마. 그건 네가 정해.
- 내가 "추천해줘"라고 답하면 네가 정하고 이유를 한 줄만 말해줘.
아직 파일은 만들지 마.
답하는 요령: 아는 건 짧게. 모르는 건 "추천해줘". 범위를 넘는 질문("결제는요?")에는 "이번엔 안 해. parking.md에 적어둬."
예약을 받고 싶으면: 미리 만든 예약 페이지 링크(구글 캘린더 예약 페이지, Calendly 등)를 여기서 AI에게 주세요. 없으면 "예약은 나중에 링크 넣을 거야. 자리만 만들어 줘."

② 요구사항 정리

배우는 것: AI가 정리하고, 내가 읽고 승인한다. 승인 전엔 안 만든다.

내 답을 반영해서 requirements.md 파일을 만들어줘. 내용은 이 순서로:
1. 한 줄 목표
2. 화면 목록: 화면마다 "보이는 것"과 "할 수 있는 것"
3. 이번에 안 하는 것
4. 네가 정한 것(색, 글꼴, 구성)과 이유 한 줄씩
쉬운 말로, 기술 용어 없이 써.
만든 뒤 내용을 화면에 보여줘. 내가 "좋아"라고 하기 전에는 코드를 만들지 마.

읽고 나서 고칠 게 있으면: 2번 화면에서 ○○은 빼고 △△을 넣어줘. 다시 보여줘. 됐으면: 좋아. 이대로 가자.

화면이 4개 이상이면 "3. 이번에 안 하는 것"으로 옮기세요. 오늘은 작게.

③ 첫 화면 하나 만들기

배우는 것: 작게 하나 만들어 눈으로 본다. 이게 기본 단위.

requirements.md대로 만들기 시작하자.

규칙:
- 정적 웹사이트로 만들어. HTML, CSS, JavaScript 파일만 써.
- 서버, 데이터베이스, 로그인, 결제가 필요한 기능은 넣지 마.
- 문의는 mailto 링크로. 서버로 보내는 폼은 만들지 마.
- 예약은 내가 준 예약 페이지 링크(구글 캘린더, Calendly 등)를 버튼이나 임베드로 연결해. 예약 기능을 직접 만들지는 마.
- 이미지는 자리만 비워 두고(placeholder) 실제 사진은 넣지 마.
- 파일은 모두 site 폴더 안에. 첫 파일은 site/index.html.
- 빌드 도구나 프레임워크 없이, 폴더를 그대로 열면 보이게 만들어.
- 모든 문구는 한국어로.

먼저 첫 화면 하나만 완성해줘. 다른 화면은 아직 만들지 마.
끝나면 site/index.html을 내 기본 브라우저로 열어줘.

브라우저가 안 열리면: 탐색기(Finder)에서 site/index.html 더블클릭.

③-b 고치기 2~3번 반복. 이 반복이 전부예요

형식: 어디 + 어떻게 + 다시 열어줘. 예시 세 개:

첫 화면 제목 글씨를 더 크게, 색은 더 차분하게 바꿔줘. 바꾸고 다시 브라우저로 열어줘.
"문의하기" 버튼을 화면 가운데로 옮기고, 누르면 내 메일(내메일@example.com)로 메일이 열리게 해줘. 다시 열어줘.
전체 분위기가 너무 딱딱해. 따뜻한 느낌으로 색을 추천해서 바꿔줘. 다시 열어줘.

마음에 안 들면: 아니, 아까 게 나아. 되돌려줘.

④ 나머지 화면

이제 requirements.md의 나머지 화면을 만들어줘.
화면 사이를 오갈 수 있는 메뉴를 모든 화면 위쪽에 넣어줘.
첫 화면의 색과 분위기를 그대로 유지해.
끝나면 다시 브라우저로 열어줘.

그다음 ③-b를 한두 번 더.

새 아이디어가 떠오르면 (주차장)

"○○ 기능"은 오늘 안 할 거야. parking.md 파일에 "다음에 할 것"으로 적어두고, 지금 작업에는 반영하지 마.

⑤ 인터넷에 올리기

배우는 것: 폴더 하나가 인터넷 주소가 된다. 사람이 하는 건 이름 정하기뿐.

이 사이트를 Cloudflare Pages에 올리자. Cloudflare 로그인은 이미 되어 있어.
1. 먼저 나에게 프로젝트 이름을 물어봐. (영문 소문자와 하이픈만, 예: coach-hong)
2. 내가 이름을 주면 이 두 명령을 순서대로 실행해:
   npx wrangler pages project create <이름> --production-branch main
   npx wrangler pages deploy site --project-name <이름> --branch main
3. 에러가 나면 네가 원인을 찾아 고치고 다시 시도해. 내가 직접 해야 하는 게 생기면 그것만 알려줘.
4. 끝나면 https://<이름>.pages.dev 주소를 알려줘.
이름 정하기: 영문 소문자, 띄어쓰기 대신 하이픈(-). 이미 있는 이름이면 뒤에 숫자. 이 이름이 주소가 돼요: 이름.pages.dev

확인: 폰 브라우저에서 주소 열기. 옆 사람 폰에서도.

⑤-b 고치고 다시 올리기 유지보수는 이게 전부

첫 화면 한 줄 소개 문구를 "○○○"로 바꿔줘. 그리고 아까와 같은 명령으로 다시 배포해줘. 끝나면 알려줘.

폰에서 새로고침 → 바뀐 것 확인.

막혔을 때 AI에게 하는 말

상황이렇게 말하기
에러가 났다에러가 났어. 원인을 찾아서 고치고 다시 해줘.
뭘 물어보는지 모르겠다쉬운 말로 다시 설명해줘. 그리고 네가 추천하는 걸 골라줘.
너무 많이 바뀌었다방금 바꾼 거 되돌려줘.
화면이 안 보인다site/index.html을 브라우저로 다시 열어줘.
AI가 멈춘 것 같다Enter 한 번. 그래도 없으면 Ctrl+C 후 다시 켜서 "이어서 해줘."
바꿨는데 화면이 그대로브라우저 새로고침 (Mac Cmd+Shift+R / Win Ctrl+F5)

집에서 다시 할 때

  1. 새 폴더 만들기 → 터미널에서 그 폴더로 → claude 또는 codex
  2. 0 (써 온 글 넣기)
  3. ① → 답하기 → ② → "좋아"
  4. ③ → ③-b 반복 → ④ → ③-b 반복
  5. ⑤ (새 이름) → ⑤-b

오늘 만든 사이트를 고칠 땐 그 폴더에서 ③-b와 ⑤-b만 반복하면 돼요.

터미널에서 폴더로 가는 법

Maccd Desktop/my-site
Windowscd Desktop\my-site

처음 설치 오늘 함께 한 것. 새 컴퓨터에서만 다시 필요해요

1. AI 도구 (자기 것 하나만)
MacWindows (PowerShell)
Claude Codecurl -fsSL https://claude.ai/install.sh | bashirm https://claude.ai/install.ps1 | iex
Codex CLIcurl -fsSL https://chatgpt.com/codex/install.sh | shpowershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

설치 뒤 터미널 창을 닫고 새로 열기 → claude 또는 codex → 브라우저 로그인 → "안녕".

2. Node (배포 도구의 바닥)

nodejs.org → 초록 LTS 버튼 → 받은 파일 실행 → 전부 다음. 터미널 새로 열고 node -v.

3. Cloudflare 로그인

npx wrangler login → y → 브라우저에서 Allow → npx wrangler whoami에 이메일 보이면 끝.