클로드 코드(Claude Code)로 블로그 및 웹 앱을 양산하는 구조 ― 하나의 사이트를 만드는 것보다 '만드는 과정'을 구축하기

Claude Code를 사용하기 시작하면 처음에는 '하나의 앱을 빠르게 만들 수 있다'는 점에 놀라게 됩니다.

하지만 더욱 효과적인 것은 '만들어지는 과정 자체(作る工程そのもの)'를 Claude Code에게 학습시켜, 두 번째, 세 번째 작업물도 동일한 품질로 작동하게 하는 것입니다.

이 글에서는 지역 정보 블로그나 작은 웹 앱을 여러 개 전개해 오면서 정립된, 양산을 위한 노하우를 정리했습니다.

① 템플릿 리포지토리(雛形)
↓
② CLAUDE.md (규칙/설계 방침)
...

핵심은 'Claude에게 어떻게 요청할지'를 매번 생각하지 않는 것입니다. 지시는 모두 파일에 작성해 둡니다.

양산의 품질은 첫 번째 템플릿으로 거의 결정됩니다.

site-template/
├── CLAUDE.md
├── .claude/
...

• 디자인, 빌드, 배포 설정은 템플릿으로 고정합니다.
• 사이트별로 바뀌는 것은 content/와 설정 파일만 남깁니다. - '샘플 기사'를 하나 넣어두면 Claude가 그것을 본보기로 삼아줍니다.

Claude Code는 프로젝트 직하단의 CLAUDE.md 파일을 매번 읽습니다. 사람에게 인계할 생각으로 작성하는 것이 요령입니다.

# 프로젝트 방침
## 목적
OO 지역의 지역 정보 블로그. 독자는 관광객과 현지 거주자.
...

**'해서는 안 될 것(やってはいけないこと)'과 '완료의 정의(完了の定義)'**를 작성해 두면, 재작업이 눈에 띄게 줄어듭니다.

.claude/commands/에 Markdown을 배치하면 /new-article처럼 호출할 수 있게 됩니다.

<!-- .claude/commands/new-article.md -->
다음 주제로 기사 1건을 작성해 주세요: $ARGUMENTS
절차:
...

사용법:

/new-article 에비스역 주변 심야까지 영업하는 카페

절차가 고정되기 때문에, 몇 건을 작성하더라도 품질이 흔들리지 않습니다.

작성 역할을 분리하고 검토 역할을 나누면 품질이 안정됩니다.

<!-- .claude/agents/reviewer.md -->
--- 
name: reviewer
...

사이트나 기능별로 worktree를 분기하면, 여러 Claude Code 세션을 동시에 실행해도 충돌하지 않습니다.

git worktree add ../site-ebisu -b site/ebisu
git worktree add ../site-harajuku -b site/harajuku

각 디렉토리에서 claude를 실행하여, 각기 다른 작업을 진행합니다.

claude -p를 사용하면 대화 없이 태스크를 실행할 수 있습니다.

#!/bin/bash
# topics.txt의 각 줄을 1개의 기사로 생성
while read -r topic; do
...

⚠️

--allowedTools로 사용할 도구를 제한하는 것이 좋습니다. 무엇이든 허용한 상태에서 무인 실행하는 것은 피해야 합니다.

• 첫 번째 작업물은 시간을 들여 템플릿과 CLAUDE.md를 만듭니다.
• 정형 작업은 슬래시 명령어 / 서브 에이전트로 구현합니다.
• worktree로 병렬 처리, claude -p로 배치(Batch) 처리 - 공개 전의
• 인간의 검토는 생략하지 않습니다.

'앱을 만드는 것'에서 '앱을 만드는 구조를 만드는 것'으로. 이것이 Claude Code로 양산할 때 가장 중요한 요령입니다.