클로드 코드 효과적 사용법: 풀 SaaS 앱 구축 경험

2021년부터 SaaS 제품을 개발해 온 개발자가 최근 Claude Code를 사용하여 codefluent.app이라는 완전한 애플리케이션을 구축했습니다. 핵심 통찰은 이 도구를 효과적으로 사용하려면 '앱을 만들어 줘'와 같은 모호한 프롬프트가 아닌 상세한 기술 사양이 필요하다는 점입니다. 개발자는 모든 아키텍처 결정을 스스로 내리면서 Claude Code가 명확한 사양을 작동하는 코드로 빠르게 변환하도록 했다고 강조합니다.

프로젝트 상세 및 기술 스택

이 프로젝트는 프로그래밍 문법 학습을 위한 간격 반복 앱인 codefluent(codefluent.app)입니다. 전체 랜딩 페이지는 Claude Code를 사용하여 섹션을 설명하고 원하는 시각적 방향을 참조하여 구축되었으며, 반응형이고 깔끔한 Tailwind 마크업이 구현되었습니다.

기술 스택:

SvelteKit 모놀리스
PostgreSQL + Drizzle ORM
Better Auth
LLM 기능을 위한 OpenRouter
Stripe
CodeMirror 6
Tailwind v4
Railway

작업 방식: 상세한 사양

개발자는 모호한 프롬프트를 사용하지 않습니다. 대신 모든 기능은 스키마, 인증 전략, 컴포넌트 계층 구조, API 형태, 에지 케이스를 포함한 정확한 요구사항을 작성하는 것부터 시작합니다. Claude Code는 기존 코드베이스를 읽고 패턴과 관례를 파악한 후 적합한 코드를 작성합니다.

사용된 예시 프롬프트:

"daily_stats 테이블을 userId, date, cardsStudied, correctCount, streakCount 열로 추가하세요. 연습 완료 시 업서트(upsert)하는 서비스 함수를 생성하세요. 사용자가 어제 연습했다면 스트릭을 증가시키고, 그렇지 않다면 1로 재설정하세요. 로그인한 사용자의 지난 30일 통계를 반환하는 서버 엔드포인트를 추가하세요."

개발자는 생성된 코드의 모든 줄을 검토하고 에지 케이스를 발견하며, 코드를 정리하고 배포합니다. 중요한 점은 어떤 테이블이 존재하는지, 인증 범위 지정이 어떻게 작동하는지, 비즈니스 규칙과 같은 아키텍처 결정은 AI가 아닌 개발자가 내린다는 것입니다.

잘 작동한 부분

데이터베이스 작업: 스키마 변경과 제약 조건을 설명하면 몇 초 만에 작동하는 Drizzle 마이그레이션이 생성되었습니다.
Stripe 통합: 결제 플로우와 웹훅 라이프사이클을 지정하면 모든 플러밍 코드가 생성되어 최소 하루 작업량을 절약했습니다.
/simplify 명령어: 이 명령어는 재사용성, 품질, 효율성을 위해 코드를 검토하며 개발자가 놓칠 수 있는 기술 부채를 발견합니다.
일관성: 경로와 서비스 구조에 대한 패턴이 확립되면 Claude Code는 최소한의 편차로 이를 유지했습니다.

어려움과 주의사항

과도한 설계: Claude Code는 일회성 사용 사례에도 추상화와 헬퍼 함수를 생성하는 경향이 있습니다. 개발자는 '더 간단하게, 직접적인 방법으로 해라'라고 적극적으로 제지해야 했습니다.
인증 복잡성: SvelteKit의 SSR 세션 처리와 함께 Better Auth를 사용하는 것은 까다로웠습니다. 생성된 패턴이 격리된 상태에서는 작동할 때도 있지만 서버 사이드 렌더링과 함께하면 문제가 발생하여 개발자가 인증 플로우를 이해하고 문제를 발견해야 했습니다.
AI 채점 시스템: 이 앱은 LLM을 사용하여 코드 설명을 채점합니다. 너무 관대하거나 엄격하지 않으면서 일관된 채점을 달성하려면 AI에 위임할 수 없는 광범위한 수동 프롬프트 반복이 필요했습니다.

핵심 요약

Claude Code는 당신이 무엇을 구축하는지 아는 것을 대체하지 않습니다. 좋은 결과와 엉망진창 사이의 차이는 명확한 사양을 작성하고 출력에서 잘못된 결정을 발견하는 능력에 달려 있습니다. 만약 이전에 프로젝트를 배포해 본 적이 있다면, 이미 무엇을 찾아야 할지 알고 있을 것입니다. 그렇지 않다면, 프롬프트 기술이 아닌 실제로 개발해야 할 기술이 바로 그것입니다.

📖 Read the full source: r/ClaudeAI