Claude Code 대규모 병렬화: 22만 줄 앱 구축 교훈

병렬 처리 전략

가장 큰 생산성 향상은 코드베이스의 다른 부분에서 3-4개의 Claude Code 인스턴스를 동시에 실행하는 데서 비롯되었습니다. 하나의 터미널은 백엔드 Cloud Functions를 처리하고, 다른 하나는 UI 컴포넌트를 리팩터링하며, 또 다른 하나는 테스트를 작성합니다. 이 접근 방식은 인스턴스가 다른 파일에서 작업하는 한 세션당 변경 사항을 2-3개에서 10-15개로 증가시켰습니다.

프롬프트 엔지니어링 기술

프롬프트 품질은 출력 품질에 직접적인 영향을 미칩니다. 복잡한 아키텍처 작업이나 까다로운 디버깅을 위해 "ultrathink"를 앞에 붙여 확장된 사고 모드를 트리거하세요. 표준 버그 수정에는 기본 모드를 사용하세요. 효과적인 프롬프트는 파일 경로, 컴포넌트 이름, 현재 동작 및 예상 동작을 지정합니다. "버그를 고쳐라"와 같은 모호한 프롬프트는 시간을 낭비합니다.

컨텍스트 관리 솔루션

Claude Code는 세션 간에 메모리가 없으므로 각 주요 세션 후에 업데이트되는 핸드오프 문서를 유지하세요. 이 문서는 구축된 내용, 문제점, 진행 중인 작업, 주요 파일 경로 및 아키텍처 결정을 다룹니다. 세션 시작 시 이를 붙여넣으면 20분 동안의 컨텍스트 재설명을 제거할 수 있습니다.

프로젝트 구성

저장소 루트에 CLAUDE.md 파일을 생성하여 코딩 규칙, 커밋 메시지 형식, 컴포넌트 패턴 및 "항상 PressableScale을 사용하고 Pressable을 사용하지 마세요" 또는 "모든 catch 블록은 unknown으로 타입 지정해야 합니다"와 같은 특정 규칙을 포함하세요. Claude Code는 자동으로 이러한 규칙을 읽고 따릅니다.

사용자 정의 명령어

반복 작업을 제거하기 위해 사용자 정의 슬래시 명령어를 구축하세요. 예를 들어, 커밋, 푸시 및 OTA 업데이트를 한 단계로 배포하는 /ship 명령어와 앱 및 Cloud Functions 모두에서 타입 검사를 실행하는 /typecheck 명령어가 있습니다.

코드베이스 감사

신속한 개발 후, Claude Code를 실행하여 전체 감사를 수행하고 문제점을 식별하세요. 한 감사에서는 136개의 보호되지 않은 console 문, 309개의 타입이 지정되지 않은 catch 블록, 죽은 파일, 보안 문제 및 성능 병목 현상을 발견했습니다. 여러 터미널에서 이러한 문제점을 병렬로 수정하여 단 하루 만에 코드베이스 품질을 크게 향상시킬 수 있습니다.

비용 및 한계

이 프로젝트는 3개월 동안 약 40억 개의 토큰을 소비하여 약 $2,000의 비용이 들었습니다. 이를 통해 AI 채팅, Plaid API를 통한 은행 통합, 7가지 테마 변형, 시장 데이터, 구독 관리 및 전체 알림 시스템을 갖춘 프로덕션 앱이 구축되었습니다. Claude Code는 매우 큰 파일(1000줄 이상)을 처리하는 데 어려움을 겪고, 때로는 추적하는 데 몇 시간이 걸리는 미묘한 버그를 도입하며, 시각적 디자인 결정을 내릴 수 없고, 세션 간에 메모리가 없습니다.

📖 전체 원문 읽기: r/ClaudeAI