Claude Code를 활용한 20,000줄 이상의 프로덕션 SaaS 플랫폼 구축: 대규모 에이전트 엔지니어링의 교훈

프로젝트 개요

LastSaaS는 Claude Code와의 대화를 통해 모든 코드가 작성된 프로덕션 SaaS 보일러플레이트입니다. 데모나 장난감이 아닌 Flipbook이라는 라이브 플랫폼을 구동합니다. 기술 스택은 Go 1.25, React 19, TypeScript, MongoDB, Tailwind를 포함하며 MIT 라이선스로 공개되었습니다.

프로젝트 구성 요소

• 멀티테넌트 인증(OAuth, MFA, 매직 링크, JWT 순환)을 갖춘 완전한 SaaS 기반
• Stripe 결제(구독, 사용자별 요금, 크레딧)
• 화이트라벨링 기능
• 19가지 웹훅 이벤트 유형
• 관리자 대시보드 및 상태 모니터링
• AI 어시스턴트가 대시보드, 사용자, 결제, 상태 데이터를 조회할 수 있는 26개의 읽기 전용 도구를 갖춘 내장 MCP 서버

효과적인 점

Go의 명시성은 에이전트에게 장점: 프레임워크의 마법이 없어 Claude Code가 미들웨어가 뒤에서 무엇을 하는지 추측할 필요가 없습니다. 명시적 오류 처리, 명확한 라우팅, 예측 가능한 패턴이 에이전트가 정확한 방향을 유지하도록 돕습니다.

일관된 패턴의 누적 효과: 핸들러, 서비스, 데이터 접근이 어떻게 구조화되는지에 대한 패턴을 초기에 확립함으로써 Claude가 수십 개의 엔드포인트에 걸쳐 높은 일관성으로 이를 복제할 수 있었고, 각 새로운 기능에 대한 부담을 크게 줄였습니다.

MCP 서버는 Claude에 의해 Claude를 위해 구축됨: 26개의 읽기 전용 도구는 AI가 시스템을 조회할 수 있는 자체적인 방법을 구축한 메타 인터페이스를 생성합니다.

MongoDB의 문서 모델이 멀티테넌시를 단순화: 데이터 모델이 경계를 명시적으로 만들어 조인 테이블 혼동과 누출되는 추상화를 피했기 때문에 Claude가 테넌트 격리를 유지하는 데 어려움이 없었습니다.

필요한 규율

여전히 아키텍처 비전이 필요: Claude Code는 뛰어난 실행자이지만 시스템을 설계하지는 않습니다. 인간은 멀티테넌트 RBAC가 어떻게 보여야 하는지, 웹훅 전송 재시도가 어떻게 작동해야 하는지, Stripe 통합 흐름이 무엇이어야 하는지와 같은 아키텍처를 제공해야 합니다.

모든 것을 검토: 특히 JWT 순환, HMAC 서명, 속도 제한, 주입 방어와 같은 보안에 민감한 코드를 검토해야 합니다. Claude는 대부분의 경우 올바르게 처리하지만, 인증 흐름에서는 '대부분의 경우'로는 충분하지 않습니다—보안과 관련된 모든 코드 줄은 인간의 검토가 필요합니다.

패턴 이탈과 싸우기: 긴 세션 동안 Claude는 확립된 패턴에서 미묘하게 이탈할 수 있습니다. 주기적으로 대화를 재정립하는 것이 도움이 됩니다: '사용자 핸들러를 어떻게 구현했는지 보세요. 웹훅에도 동일한 패턴을 따르세요.'

'에이전트를 위해 구축됨' 개념

이 코드베이스는 누군가가 포크하고 자신의 AI 에이전트를 연결할 때 에이전트가 유창하게 확장할 수 있도록 의도적으로 구조화되었습니다. 여기에는 예측 가능한 파일 구조, 일관된 명명 규칙, 명시적 패턴이 포함됩니다—대화를 통해 확장되도록 설계된 기반입니다.

저장소는 https://github.com/jonradoff/lastsaas에서 확인할 수 있습니다.