바이브코딩을 시작하기 위한 첫 번째 단계는 올바른 도구 선택입니다. 클로드 코드는 Anthropic이 직접 만든 개발 도구로, 토큰을 충분히 사용하여 높은 완성도의 코드를 생성합니다. 반면 커서는 API 비용 절감을 위해 토큰을 아껴 사용하므로 맥락을 놓치거나 실수가 잦습니다.

권장 요금제: 맥스 $200 요금제를 사용하면 Opus 모델을 자유롭게 사용할 수 있습니다. 이는 API로 사용할 때보다 10배 이상의 가치를 제공하며, 개발자 연차로 2-3년의 경험 차이에 해당합니다.

필수 MCP 연동:

# Context7 MCP 연동 (사용자 레벨로 설정)
claude mcp add --scope user --transport http context7 https://mcp.context7.com/mcp

# 토스페이먼츠 MCP 연동
claude mcp add -s user tosspayments-integration-guide npx -- -y @tosspayments/integration-guide-mcp@latest

컨텍스트 관리: /compact 명령어로 히스토리를 요약하여 속도를 유지하세요. 각 작업마다 새로운 세션을 사용하면 컨텍스트 오염을 방지할 수 있습니다.

Rails 8에서는 SQLite 성능이 획기적으로 개선되어 초당 수천 건의 쓰기와 동시 읽기가 가능합니다. 10만 사용자까지는 SQLite로 충분하며, 배포와 운영이 훨씬 간단합니다.

Rails credentials 사용법:

EDITOR="code --wait" bin/rails credentials:edit

.env 대신 Rails credentials를 사용하면 배포가 훨씬 편리합니다. master.key 파일은 gitignore에 포함되어 보안도 안전합니다.

CSS 로드 주의사항: application.erb에서 CSS를 로드할 때 "application"이 아닌 :app으로 로드해야 action text CSS까지 포함됩니다.

권장 gem 목록:
- devise: 로그인/인증 (5분 내 구현 가능)
- rails_icons: tabler 아이콘 사용
- resend: 이메일 발송
- exception_notification: 오류 알림
- solid_queue: 백그라운드 작업

전체 기획을 완성하고 시작하는 워터폴 방식보다는, 조금씩 만들고 수정하는 애자일 방식이 바이브코딩에 더 적합합니다.

개발 순서:
1. 핵심 기능만 포함한 MVP 먼저 구현
2. 시각적 결과물을 보며 수정 지시
3. 디테일은 나중에 추가

프롬프트 작성 팁:
- "바로 시작하지 말고 계획을 먼저 세우고 확인 후 진행하자"
- 디자인 요청 시: "컴팩트하게", "스크롤바 없이", "한눈에 보이게"
- 구체적이고 명확한 지시가 중요

병렬 개발: 여러 프로젝트 폴더에서 각각 claude 명령을 실행하면 병렬 개발이 가능합니다. git worktree를 활용하면 브랜치 관리보다 편리합니다.

새 창을 열 때마다 컨텍스트가 초기화됩니다. 이를 관리하는 방법:

# 이전 세션 이어서 작업
claude --continue
claude --resume

# 프로젝트 초기화 (컨텍스트 설정)
/init

CLAUDE.md 활용:
프로젝트의 컨텍스트를 유지하려면 CLAUDE.md 파일에 개발 내용을 업데이트하세요. AI가 자동으로 이를 참고합니다.

터보스트림과 스티뮬러스를 활용하면 JavaScript를 최소화하면서도 동적인 UI를 구현할 수 있습니다.

터보스트림 참고 자료: https://github.com/hotwired/turbo-rails

Import Maps 활용: JavaScript 모듈을 빌드 없이 사용할 수 있습니다.

bin/importmap pin [package-name]

Tailwind CSS 팁:
- shadcn 스타일로 디자인 요청
- 커스텀 CSS 클래스 대신 Tailwind 유틸리티만 사용
- Tailwind 4는 설정 파일이 필요 없음

여러 기능을 동시에 개발할 때 git worktree를 활용하면 효율적입니다.

# 새로운 워크트리 생성
git worktree add ../myproject-feature feature-branch

# 병렬로 클로드 코드 실행
claude # 첫 번째 터미널
claude # 두 번째 터미널 (다른 폴더에서)

장점:
- 브랜치 전환 없이 병렬 작업 가능
- 각 기능별로 독립적인 개발 환경
- 프로젝트 폴더를 복사하여 백업 효과

"기능 구현 하나마다 폴더 하나씩 생성해서 백업하고 메모하는" 방식이 효과적입니다.

백업 시점:
- 주요 기능 구현 완료 시
- 대규모 변경 전
- 배포 전

주의사항:
- 한 번에 모든 기능을 구현하려 하지 마세요
- 중간 백업 지점을 만들어 복구 가능하도록
- "원큐엔 절대 안됩니다"

AI와 함께 개발할 때는 BDD(Behavior Driven Development) 방식이 더 효과적입니다.

이유:
- Unit test는 AI가 세부사항에 집착하게 만듦
- 수정이 잦은 초기 개발에는 통합 테스트가 유리
- Playwright MCP로 화면 테스트 자동화 가능

프롬프트 예시:
"이 기능에 대한 BDD 스타일 테스트를 작성해줘"

국내 결제: 토스페이먼츠가 가장 연동이 쉽고 대응이 빠릅니다. 사업자 등록 없이도 테스트 가능합니다.

해외 결제: Stripe는 해외 법인이 필요하므로, Lemon Squeezy를 사용하는 것이 대안입니다.

연동 문서: https://docs.tosspayments.com/guides/v2/payment-widget/integration

사업자 등록 팁: 정부지원사업(예비창업패키지 등)을 받을 계획이라면 사업자 등록 시기를 고려하세요.

수익화 방법:
1. 홈페이지 외주 (50만원부터 시작)
2. 기업 내 반복 작업 자동화
3. SaaS 직접 개발하여 운영
4. 플랫폼/마켓플레이스 구축

외주 비용 절감 사례: 100만원 견적의 수정 작업을 $20 Sonnet 모델로 해결

MVP 전략: 핵심 기능만 포함하여 빠르게 출시 후 사용자 피드백으로 개선

"수익화는 저도 돈을 가장 빨리 번 게 결국 외주"

외주 시작 팁:
- 100만원 견적 작업을 $20로 해결한 사례
- 주변 홈페이지부터 시작
- 포트폴리오 축적 후 단가 상승

Kamal은 Docker 컨테이너를 사용하여 복잡한 쿠버네티스 없이도 간편하게 배포할 수 있습니다.

서버 선택 가이드:
- 초기: DigitalOcean, Vultr ($5-20/월)
- 국내: 네이버 클라우드, AWS Lightsail
- 8만원 서버로 5만 회원까지 운영 가능

백업 전략:
- SQLite 파일을 S3에 정기 백업
- whenever gem으로 크론잡 자동화
- exception_notification으로 오류 모니터링

도메인 선택:
- SaaS: .io
- AI 서비스: .ai
- 국내 전용: .kr
- 유틸리티: .app

초기에는 SQLite로 충분하며, 사용자가 10만명을 넘어갈 때 PostgreSQL로 마이그레이션하면 됩니다.

성능 개선 순서:
1. 서버 사양 업그레이드 (가장 간단)
2. 캐싱 적용
3. DB 인덱싱
4. 서버 분리 (마지막 수단)

SQLite 성능 참고: https://joyofrails.com/articles/what-you-need-to-know-about-sqlite

레일즈 프로젝트에서는 Rails credentials 사용이 권장되지만, 복잡한 경우:
- Infisical 또는 Vault 같은 관리 도구 사용
- 프롬프트에 시크릿 관리 방식 명시
- master.key는 절대 git에 포함시키지 않기

서버 재시작이 필요한 경우:
- 라이브러리 설치 후
- 다국어 설정 변경 후
- 중요한 설정 변경 후

Ctrl+C로 종료 후 bin/dev

git 관련 팁:
- commit: 로컬에 변경사항 저장
- push: 원격 저장소에 동기화
- 프로젝트 이동 시 폴더 통째로 복사 (DB 포함)

디버깅 팁:
- 문서 참고시키기
- 요청 문장을 더 명확하게
- 구체적이고 명확한 지시

Windows WSL 환경에서 이미지가 인식되지 않을 때:
- WSL 환경 내 폴더에 파일을 넣고 호출
- 한글 폴더명 피하기 (영문 폴더명 사용)
- Windows 사용자명도 영어로 설정 권장

클로드 코드로 해결이 안 될 때:
1. GPT-4에 코드를 올리고 문제점 해결 요청
2. 다른 AI의 관점에서 새로운 해결책 발견
3. 각 AI의 장점을 활용한 문제 해결

레일즈는 프론트/백/DB가 통합되어 있어 AI가 권한 설계를 더 안전하게 수행합니다. 반면 수파베이스나 파이어베이스는 RLS 설정을 놓치면 데이터 유출 위험이 있습니다.

레일즈 내장 보안 기능:
- CSRF 보호
- SQL 인젝션 방지
- XSS 방지
- bcrypt 비밀번호 암호화

AWS 보안 주의사항: 루트키 노출 시 수억원 피해 가능. GitHub에 실수로 키를 올리지 않도록 주의하세요.

레일즈는 프론트/백/DB가 통합되어 있어 AI가 권한 설계를 더 안전하게 수행합니다. 반면 수파베이스나 파이어베이스는 RLS 설정을 놓치면 데이터 유출 위험이 있습니다.

레일즈 내장 보안 기능:
- CSRF 보호
- SQL 인젝션 방지
- XSS 방지
- bcrypt 비밀번호 암호화

AWS 보안 주의사항: 루트키 노출 시 수억원 피해 가능. GitHub에 실수로 키를 올리지 않도록 주의하세요.

프로젝트 참고 방법:
"이 경로의 프로젝트에서 로그인 기능 참고해서 비슷하게 구현해줘"

프레임워크 전환:
"이 리액트 프로젝트를 레일즈로 변환해줘. 라우팅, DB 구조, UI는 최대한 비슷하게"

테스트 작성 시점: 사이드이펙트가 빈번하게 발생하면 E2E 테스트 요청

비싼 SaaS 대신 필요한 협업 도구를 직접 만드는 것이 효율적입니다.

장점:
- 월 수백만원 비용 절감
- 팀에 맞는 맞춤형 기능
- 러닝커브 없는 간단한 UI

구현 예시:
- 어드민 패널: "워크스페이스 가입자 관리하는 어드민 만들어줘"
- 한 번에 완성도 높은 결과물 생성
- shadcn 스타일로 일관된 디자인

"극 초기 코드 개발 빼고는 안하는 걸 추천"

이유:
- AI가 자기 마음대로 수정하는 경우 발생
- 번거롭더라도 매번 확인 필요
- 나중에 디버깅이 더 어려워짐

바이브코딩은 아직 초기 단계이며, 앞으로 몇 년간 큰 기회가 있을 것으로 예상됩니다.

경쟁력 확보 방법:
- 지금부터 시작하여 경험 축적
- 비즈니스 감각과 기술 능력 균형
- 적극적인 피벗과 전략적 대응

개발자 vs 비개발자: 개발 지식이 없는 분들이 오히려 AI를 더 적극적으로 활용하는 경향이 있습니다. 몇 개월이면 10년차 PM 수준의 기술 이해도를 갖출 수 있습니다.

"대기업 시니어 개발자들도 회사에서 강제로 못 쓰게 해도 알게 모르게 다들 쓰고 싶어함"

현실:
- 회사 밖에서 사용하는 경우 많음
- 새로운 스택 습득에 AI 의존
- 바이브코딩을 부정하면서도 실제로는 활용