AI 정보

2편: 바이브코딩으로 포폴 사이트 만들기 — CLAUDE.md랑 프롬프트 전략 공개

체리플랜 2026. 4. 14. 08:49
반응형

 

https://cherrycoding0.tistory.com/15

 

1편: Claude Code로 7일 만에 앱 9개 포폴만들기

저는 현직 프론트엔드 개발자예요.React, TypeScript 매일 쓰고, 코드 짜는 게 업무의 전부인 사람이에요.근데 Claude Code랑 작업하고 나서 개발 방식 자체가 바뀌었어요.7일 만에 앱 9개짜리 포트폴리

cherrycoding0.tistory.com

 

🍒 CherryPlan — 프로젝트 가이드

1편에서 CherryPlan 결과물 보셨죠?

오늘은 실제로 어떻게 만들었는지 개발자 시각으로 풀어볼게요.

핵심은 두 가지예요. CLAUDE.md랑 프롬프트 패턴.

코딩 몰라도 이 구조만 이해하면 따라할 수 있어요.


1. CLAUDE.md — AI한테 주는 프로젝트 설명서

Claude Code를 처음 쓰면 매번 이런 걸 설명하게 돼요:

"컬러는 #FF6B8A 써줘, rounded-2xl 써줘, localStorage만 써줘..."

개발자 입장에서 이건 매번 컨텍스트를 처음부터 설명하는 것과 같아요.

토큰 낭비고, 결과물도 들쭉날쭉해지거든요.

CLAUDE.md는 프로젝트 루트에 두는 파일이에요.

Claude Code가 실행될 때 이 파일을 자동으로 읽어서 프로젝트 규칙으로 인식해요.

한 번만 잘 써두면, 이후 모든 요청에 자동 적용돼요.

저는 이렇게 적어뒀어요:

## 디자인 시스템
- 메인 컬러: #FF6B8A (체리 핑크)
- 버튼: rounded-full
- 카드: rounded-2xl shadow-md

## 절대 하지 말 것
- ❌ 외부 DB 연결 — localStorage만
- ❌ 단일 컴포넌트 500줄 초과
- ❌ console.log 남기기

"절대 하지 말 것" 섹션이 핵심이에요.

AI는 명시적으로 금지하지 않으면 자기 판단으로 Firebase 연동하고, 컴포넌트 1000줄 짜고, console.log 잔뜩 남겨요.

초보자분들이 AI 결과물이 이상하다고 느끼는 이유가 대부분 여기에 있어요.


2. 프롬프트 패턴 — 짧고 구체적으로

막연하게 "앱 만들어줘" 하면 결과가 엉망이에요.

이건 AI 문제가 아니라 요구사항이 불명확한 문제예요. 개발 팀에서도 똑같은 일이 일어나거든요.

저는 이 패턴으로 고정해서 썼어요!

 

[파일명].jsx를 만들어줘.

핵심 기능:
- 기능 1
- 기능 2

저장: localStorage [키 이름]
디자인: CherryPlan 시스템 통일

 

왜 짧아야 하냐면 — Claude Code는 한 번에 처리할 수 있는 컨텍스트 양이 정해져 있어요.

요청이 길고 복잡할수록 앞에서 말한 내용을 놓치기 시작해요.

작은 단위로 쪼개서 하나씩 완성하는 게 훨씬 안정적이에요.

 

잘못된 프롬프트 vs 잘된 프롬프트 비교:

❌ "포모도로 타이머 만들어줘. 예쁘게, 기능도 많이, 알림도 되고, 통계도 보여주고, 다크모드도"

✅ "Pomodoro.jsx 만들어줘.
   집중 25분 / 휴식 5분 타이머.
   세션 완료 시 localStorage cherryplan_pomodoro에 저장.
   디자인 CherryPlan 시스템 통일."

 


3. 앱 하나 추가하는 데 얼마나 걸리냐면

무드 트래커 기준:

  • 프롬프트 작성: 10분
  • Claude Code 생성: 2분
  • 코드 검토 + 방향 수정: 15분

총 30분이 안 걸렸어요.

여기서 "코드 검토"가 중요해요.

저는 개발자라서 결과물 코드를 직접 읽고 구조가 맞는지 확인했어요.

코딩을 모르더라도, 앱이 의도대로 작동하는지 직접 클릭해보면서 확인하는 과정은 꼭 필요해요.

AI가 짠 걸 그냥 올리면 나중에 버그가 쌓여요.

첫 세팅(CLAUDE.md 작성, 라우터 구조 잡기)에 반나절 정도 걸렸어요.

이게 기반이 되니까 이후 앱들은 계속 빨라졌어요.


직접 해보고 싶으시면

 

https://github.com/cherrycoding0/cherryplan

  1. GitHub cherrycoding0/cherryplan 포크하기
  2. CLAUDE.md 구조 보면서 "왜 이렇게 썼지?" 생각해보기
  3. 내 아이디어로 앱 하나 추가해보기

지금 바로 실습해보는 방법 — 무료로

"해보고 싶은데 Claude Code 유료 구독이 없어요" 하시는 분들 많더라고요.

걱정 마세요. 지금 당장 무료로 실습할 수 있는 방법이 두 가지 있어요.

🥇 방법 1 — Claude.ai Artifacts (추천, 설치 없음)

가장 빠르게 따라할 수 있는 방법이에요. 설치 없이 브라우저 하나면 돼요.

  1. claude.ai 접속 (무료 회원가입)
  2. 대화창에 아래 프롬프트 그대로 복붙
  3. 오른쪽에 Artifact 창에서 결과물 바로 확인
포모도로 타이머를 만들어줘.

핵심 기능:
- 집중 25분 / 휴식 5분 타이머
- 세션 완료 시 localStorage에 저장

디자인:
- 메인 컬러 #FF6B8A
- 버튼 rounded-full
- 카드 rounded-2xl

Claude Code 없이도 이 프롬프트 패턴 그대로 작동해요.

같은 구조, 같은 결과물. 차이는 터미널이냐 브라우저냐예요.

🥈 방법 2 — Gemini CLI (무료 + CLI 감각까지)

https://geminicli.com/

 

Build, debug & deploy with AI

 

geminicli.com

 

Claude Code처럼 터미널에서 AI 코딩을 직접 경험해보고 싶다면 이걸 추천해요.

Google이 공식 출시한 CLI 툴이고, 완전 무료에 설치도 간단해요.

npx <https://github.com/google-gemini/gemini-cli>

명령어 하나로 실행되고, 위에서 공개한 프롬프트 패턴 그대로 쓸 수 있어요.

Claude Code로 넘어가기 전에 CLI 바이브 코딩 감 익히기엔 지금 가장 좋은 선택이에요.


Claude.ai Artifacts Gemini CLI

설치 불필요 Node.js 필요
비용 무료 무료
CLI 감각
바로 실행
신뢰도 Anthropic 공식 Google 공식

막히는 부분 있으면 댓글 남겨주세요.

3편에서는 실제로 삽질했던 순간들 — CORS 에러, Notion 연동 오류, 한글 깨짐까지 전부 털어놓을게요.

미리 알면 삽질 시간을 확 줄일 수 있어요 🍒

 

https://cherrycoding0.tistory.com/18

 

3편: 바이브코딩으로 포폴 사이트 만들기 — 막혔던 순간들이랑 배운 것들

https://cherrycoding0.tistory.com/15 1편: Claude Code로 7일 만에 앱 9개 포폴만들기저는 현직 프론트엔드 개발자예요.React, TypeScript 매일 쓰고, 코드 짜는 게 업무의 전부인 사람이에요.근데 Claude Code랑 작업

cherrycoding0.tistory.com

 

반응형