게임 기획자를 위한 Claude Code 완전 활용 가이드 — 사양서부터 밸런싱까지

들어가며

이 가이드는 프로그래밍 경험이 없는 게임 기획자가 Claude Code를 업무에 즉시 활용할 수 있도록 작성된 교육 자료다. 코드를 직접 작성할 필요 없이, Claude에게 자연어로 요청하는 방법을 중심으로 설명한다.

이 문서는 사내 교육 및 워크숍 자료로 활용할 수 있도록 구성되었다.

이 가이드에서 다루는 내용

Part	주제	핵심 질문
Part 1	기초 설정	Claude Code를 어떻게 시작하나?
Part 2	사양서 워크플로우	기획서를 어떻게 체계적으로 쓰고 검증하나?
Part 3	데이터 분석 & 시각화	데이터를 어떻게 분석하고 보여주나?
Part 4	게임 밸런싱	수치 설계를 어떻게 자동화하나?
Part 5	에이전트 종합 활용	어떤 에이전트를 언제 쓰나?
부록	프롬프트 모음	바로 복사해서 쓸 수 있는 프롬프트

---

Part 1: 기초 설정

1-1. Claude Code란?

Claude Code는 Anthropic이 제공하는 터미널 기반 AI 어시스턴트다. 일반 채팅과 달리:

• 파일을 직접 읽고 쓸 수 있다
• Python 스크립트를 작성하고 실행할 수 있다
• 여러 에이전트를 동시에 활용할 수 있다
• 프로젝트 컨텍스트를 이해하고 기억한다

1-2. 기획자에게 필요한 최소 환경

필수:
  - Claude Code 설치 완료
  - 작업용 폴더 (프로젝트 디렉토리)

권장:
  - Python 설치 (데이터 분석/시각화용)
  - Google Cloud 서비스 계정 (Sheets 연동용)

1-3. 첫 실행 — 기획자를 위한 기본 명령어

Claude Code를 실행한 뒤, 자연어로 말하면 된다.

나: "기획서 폴더 구조를 만들어줘"
Claude: docs/plan/, docs/design/, docs/data/ 폴더를 생성합니다

별도의 명령어 암기가 필요 없다. 하고 싶은 것을 그대로 말하면 된다.

---

Part 2: 사양서 워크플로우

게임 기획자의 핵심 업무인 사양서 작성 → 검증 → 기술사양서 변환을 Claude Code로 자동화하는 방법.

2-1. 기획서 작성 — /pdca plan

기본 사용법

나: /pdca plan gacha-system

이 한 줄로 Claude가 다음을 자동 생성한다:

• 기능 개요
• 유저 스토리
• 기능 요구사항 목록
• 우선순위 분류
• 리스크 분석

생성되는 문서 예시

# 가챠 시스템 기획서

## 1. 개요
플레이어가 게임 내 재화를 소모하여 랜덤 아이템을 획득하는 시스템

## 2. 유저 스토리
- 플레이어는 단일 뽑기(1회)를 할 수 있다
- 플레이어는 연속 뽑기(10회)를 할 수 있다
- 플레이어는 천장(pity) 시스템으로 확정 보상을 받을 수 있다
...

## 3. 기능 요구사항
### P0 (필수)
- [ ] 확률 테이블 기반 랜덤 아이템 지급
- [ ] 천장 카운터 관리
- [ ] 재화 차감 및 부족 시 에러 처리
...

더 상세한 기획서가 필요할 때 — plan-plus

나: /plan-plus gacha-system

plan-plus는 일반 /pdca plan보다 강화된 버전으로:

1. 의도 탐색 — “왜 이 기능이 필요한가?”를 먼저 질문
2. 대안 비교 — 2~3가지 설계 방안을 비교 분석
3. YAGNI 리뷰 — 지금 당장 필요하지 않은 기능 제거 제안

기획 초기 단계에서 브레인스토밍이 필요할 때 효과적이다.

2-2. 사양서 검증 — design-validator

기획서를 작성한 뒤, 빠진 항목이나 모순이 없는지 자동 점검한다.

사용법

나: "docs/plan/gacha-system.md 사양서를 검증해줘"

Claude가 검출하는 항목들

검증 항목	예시
누락된 필드	“에러 처리 시나리오가 정의되지 않았습니다”
수치 모순	“최대 보상 10개인데, 보상 테이블에 12개 항목이 있습니다”
용어 불일치	“2절에서는 ‘다이아몬드’, 3절에서는 ‘보석’으로 혼용됩니다”
경계 조건 누락	“재화가 0인 상태에서의 동작이 정의되지 않았습니다”
의존성 미정의	“인벤토리 시스템과의 연동 방식이 명시되지 않았습니다”

실전 팁

나: "이 사양서에 빠진 항목 있어?"
나: "이 기획서 내용 중 모순되는 부분 찾아줘"
나: "QA팀이 지적할 만한 포인트를 미리 찾아줘"

2-3. 기술사양서 변환 — /pdca design

기획서가 완성되면, 개발팀이 바로 작업할 수 있는 기술사양서로 변환한다.

사용법

나: /pdca design gacha-system

변환 결과 예시

기획서의 “확률 테이블 기반 랜덤 아이템 지급”이 다음과 같이 변환된다:

## API 설계

### POST /api/gacha/pull
- Request: { userId, poolId, count: 1|10 }
- Response: { items: [...], pityCounter, remainCurrency }

## 데이터베이스 스키마

### gacha_pools
| 컬럼 | 타입 | 설명 |
|------|------|------|
| id | UUID | 가챠 풀 ID |
| name | VARCHAR | 풀 이름 |
| rates | JSONB | 등급별 확률 |

### gacha_history
| 컬럼 | 타입 | 설명 |
|------|------|------|
| id | UUID | 기록 ID |
| user_id | UUID | 유저 ID |
| pool_id | UUID | 풀 ID |
| items | JSONB | 획득 아이템 목록 |
| pity_count | INT | 천장 카운터 |

기획자가 직접 API나 DB를 설계할 필요 없이, 기획 의도를 기술 언어로 자동 번역해준다.

2-4. 사양서 ↔ 구현 갭 분석 — gap-detector

개발이 진행된 후, 사양서대로 구현되었는지 확인한다.

나: "사양서와 실제 구현 코드를 비교해서 갭 분석해줘"

결과:

📊 Gap Analysis Report
━━━━━━━━━━━━━━━━━━━━━
Match Rate: 78%

❌ 미구현 항목:
  - 천장 카운터 초기화 로직 (사양서 3.2절)
  - 10연차 보너스 아이템 지급 (사양서 3.5절)

⚠️ 사양서와 다른 구현:
  - 확률 소수점 처리: 사양서는 반올림, 구현은 버림

✅ 정상 구현: 12/16 항목

90% 미만이면 자동으로 수정 제안을 받을 수 있다.

---

Part 3: 데이터 분석 & 시각화

기획자가 가장 많이 활용하게 될 영역. Claude에게 데이터를 주고 분석과 시각화를 요청하면, Python 스크립트를 자동으로 작성하고 실행한다.

3-1. CSV/Excel 데이터 분석

기본 패턴

나: "data/user_logs.csv 파일을 분석해서
    유저 이탈 구간을 찾아줘"

Claude가 수행하는 작업:

1. CSV 파일 읽기 (pandas)
2. 유저별 플레이 패턴 분석
3. 이탈 포인트 감지
4. 결과 요약 및 시각화

실전 요청 예시

# 기본 통계
나: "이 CSV의 기본 통계(평균, 중앙값, 분포)를 보여줘"

# 필터링
나: "레벨 30 이상 유저만 추출해서 과금률을 분석해줘"

# 비교 분석
나: "A 그룹과 B 그룹의 리텐션 차이를 비교해줘"

# 시계열 분석
나: "월별 DAU 추이를 그래프로 보여줘"

3-2. KPI 지표 설계 & 분석

게임 KPI 프레임워크 요청

나: "모바일 RPG의 핵심 KPI 프레임워크를 만들어줘.
    카테고리별로 정리하고, 각 지표의 계산 공식과
    건강한 기준값을 포함해줘"

Claude가 생성하는 프레임워크:

## 유저 획득 지표
| KPI | 공식 | 건강 기준 |
|-----|------|----------|
| DAU | 일일 접속 유저 수 | - |
| MAU | 월간 접속 유저 수 | - |
| DAU/MAU | DAU ÷ MAU | 20~30% |

## 참여도 지표
| KPI | 공식 | 건강 기준 |
|-----|------|----------|
| 세션 길이 | 평균 플레이 시간 | 15~30분 |
| 세션 빈도 | 일 평균 접속 횟수 | 2~4회 |
| D1 리텐션 | Day1 접속 ÷ 설치 | 40~50% |
| D7 리텐션 | Day7 접속 ÷ 설치 | 15~25% |
| D30 리텐션 | Day30 접속 ÷ 설치 | 5~10% |

## 수익 지표
| KPI | 공식 | 건강 기준 |
|-----|------|----------|
| ARPU | 총 매출 ÷ 활성 유저 | 장르별 상이 |
| ARPPU | 총 매출 ÷ 과금 유저 | ARPU의 10~50배 |
| 과금률 | 과금 유저 ÷ 활성 유저 | 2~5% |
| LTV | ARPU × 평균 수명 | CPI의 3배 이상 |

퍼널 분석

나: "튜토리얼 퍼널 데이터야.
    스텝별 이탈률을 계산하고 차트로 보여줘.

    Step1_시작: 10000
    Step2_캐릭터생성: 8500
    Step3_첫전투: 7200
    Step4_보상획득: 6800
    Step5_두번째전투: 4100
    Step6_마을도착: 3800
    Step7_튜토리얼완료: 3500"

Claude가 자동으로:

1. 스텝 간 이탈률 계산
2. 전환율 퍼널 차트 생성
3. 가장 심각한 이탈 구간 하이라이팅
4. 개선 포인트 제안 (예: “Step4→Step5에서 38% 이탈. 두 번째 전투 난이도 또는 보상 부족 검토 필요”)

3-3. 데이터 시각화

차트 유형별 요청 방법

# 막대 차트
나: "카테고리별 매출 데이터를 막대 차트로 그려줘"

# 선 그래프
나: "30일간 DAU 추이를 선 그래프로 보여줘"

# 히트맵
나: "시간대별, 요일별 동시 접속자를 히트맵으로 보여줘"

# 파이 차트
나: "재화 소모처 비율을 파이 차트로 보여줘"

# 박스플롯
나: "레벨 구간별 세션 시간 분포를 박스플롯으로 보여줘"

# 산점도
나: "플레이 시간과 과금액의 상관관계를 산점도로 보여줘"

대시보드 생성

나: "다음 데이터로 HTML 대시보드를 만들어줘.
    인터랙티브하게 필터링할 수 있으면 좋겠어.
    - DAU/MAU 추이
    - 매출 추이
    - 리텐션 커브
    - 컨텐츠별 소비 현황"

Claude가 plotly 기반의 인터랙티브 HTML 대시보드를 생성한다. 브라우저에서 바로 열어볼 수 있다.

3-4. Google Workspace 연동

Google Sheets 데이터 읽기

나: "Google Sheets에서 데이터를 읽어오는 Python 스크립트를 만들어줘.
    시트 이름: '유저통계_2026Q1'
    필요한 컬럼: date, dau, revenue, new_users"

Claude가 생성하는 코드 구조:

# 1. Google API 인증 설정
# 2. 시트 데이터 읽기
# 3. pandas DataFrame으로 변환
# 4. 분석 및 시각화

자동화 워크플로우

나: "매일 Google Sheets의 데이터를 읽어서
    자동으로 일일 리포트를 생성하는 스크립트를 만들어줘"

구성:

1. Sheets API로 데이터 수집
2. 전일 대비 변화율 계산
3. 이상치 감지 (급격한 DAU 하락 등)
4. 요약 리포트 마크다운 자동 생성

Sheets에 분석 결과 쓰기

나: "분석 결과를 Google Sheets의 '분석결과' 시트에 자동으로 써줘"

---

Part 4: 게임 밸런싱

4-1. 수치 테이블 설계

경험치/레벨 커브

나: "레벨 1~100 경험치 테이블을 만들어줘.
    조건:
    - 레벨 1→2: 100 EXP
    - 레벨 99→100: 500,000 EXP
    - 초반(1~20)은 완만하게, 후반(80~100)은 가파르게
    - 곡선 타입: 지수 증가

    CSV와 그래프 둘 다 출력해줘"

Claude가 수행하는 작업:

1. 지수 함수 파라미터 피팅 (시작값 100, 끝값 500,000)
2. 레벨별 필요 경험치 테이블 CSV 생성
3. 누적 경험치 그래프 출력
4. 레벨업 예상 소요 시간 (분당 EXP 기준) 계산

스탯 성장 곡선

나: "전사 클래스의 레벨별 스탯 테이블을 만들어줘.

    기본값 (레벨 1):
    - HP: 500, ATK: 50, DEF: 30, SPD: 10

    레벨 100 목표값:
    - HP: 50000, ATK: 3000, DEF: 2000, SPD: 100

    성장 곡선: HP와 DEF는 선형, ATK는 지수, SPD는 로그

    레벨 10 단위로 테이블과 그래프를 보여줘"

재화 경제 모델

나: "게임 경제 시뮬레이션을 만들어줘.

    일일 유입:
    - 일일 퀘스트: 골드 500
    - 던전 보상: 골드 300~800 (평균 550)
    - 출석 보상: 골드 200

    일일 유출:
    - 장비 강화: 골드 100~2000
    - 소모품 구매: 골드 200~500
    - 가챠: 골드 300 (1회)

    30일 시뮬레이션으로
    골드 인플레이션이 발생하는지 확인해줘"

결과:

• 일일 순수익 변화 그래프
• 30일 후 예상 보유 골드 분포
• 인플레이션 위험 구간 표시
• 조정 제안 (예: “Day 15부터 유입이 유출을 초과. 골드 싱크 추가 필요”)

4-2. 확률 시뮬레이션

가챠 확률 검증

나: "가챠 확률표를 시뮬레이션으로 검증해줘.

    확률:
    - SSR: 1.5%
    - SR: 13.5%
    - R: 85%

    천장: 90연차 이내 SSR 미획득 시 확정
    10연차 보너스: SR 이상 1개 확정

    10만 번 시뮬레이션으로:
    1. 실제 SSR 획득률이 표기와 일치하는지
    2. 천장까지 가는 비율
    3. SSR 1개 획득까지 평균 투자량
    을 확인해줘"

Claude가 수행하는 몬테카를로 시뮬레이션:

📊 시뮬레이션 결과 (10만 회)
━━━━━━━━━━━━━━━━━━━━━━━━━━
실제 SSR 획득률: 1.52% (표기: 1.5%) ✅
천장 도달 비율: 25.3%
SSR 1개까지 평균: 47.2회 (중앙값: 42회)
SSR 1개까지 최악: 90회 (천장)

💡 분석:
- 4명 중 1명은 천장까지 감
- 평균 과금액 (1회 300원 기준): 14,160원
- 상위 10% 행운: 12회 이내 SSR 획득

드롭률 시뮬레이션

나: "보스 드롭 테이블의 기대 수익을 계산해줘.

    드롭 테이블:
    - 전설 무기 (0.5%)
    - 영웅 장비 (5%)
    - 희귀 재료 (20%)
    - 일반 재료 (74.5%)

    각 아이템의 골드 가치:
    - 전설: 100,000
    - 영웅: 10,000
    - 희귀: 1,000
    - 일반: 100

    보스를 100번 잡았을 때 예상 수익 분포를 보여줘"

4-3. 전투 밸런싱

DPS/EHP 분석

나: "5개 클래스의 전투 밸런스를 분석해줘.

    전사: HP 5000, ATK 300, DEF 200, SPD 80, 스킬배율 1.5
    마법사: HP 2500, ATK 500, DEF 80, SPD 100, 스킬배율 2.0
    궁수: HP 3000, ATK 400, DEF 100, SPD 120, 스킬배율 1.8
    힐러: HP 3500, ATK 150, DEF 150, SPD 90, 스킬배율 1.0 (힐)
    암살자: HP 2000, ATK 450, DEF 60, SPD 150, 스킬배율 2.5

    DPS(초당 피해량)와 EHP(유효 체력)를 계산하고
    밸런스가 맞는지 레이더 차트로 보여줘"

난이도 곡선 분석

나: "스테이지 1~50 몬스터 데이터 CSV를 줄게.
    난이도 곡선이 자연스러운지 분석하고,
    난이도가 급상승하는 벽(wall) 구간을 찾아줘.

    비교 기준:
    - 같은 레벨 플레이어 평균 스탯 대비 몬스터 스탯 비율
    - 클리어 예상 시간 변화"

---

Part 5: 에이전트 종합 활용

5-1. 기획자가 알아야 할 핵심 에이전트

에이전트	한 줄 설명	기획자 활용 장면
product-manager	요구사항 분석 + 유저스토리 작성	기획 초기, 요구사항 정리할 때
design-validator	사양서 완성도 검증	기획서 리뷰 단계
gap-detector	사양서 vs 구현 비교	QA 또는 개발 중간 점검
qa-strategist	QA 전략 수립	테스트 계획 작성할 때
code-analyzer	코드 품질 분석	개발 결과물 검수할 때
report-generator	완료 보고서 생성	마일스톤 완료 시

5-2. 실전 워크플로우 — 신규 기능 기획부터 출시까지

Step 1: 기획 — /pdca plan {기능명}
         ↓
Step 2: 검증 — design-validator로 사양서 점검
         ↓
Step 3: 기술변환 — /pdca design {기능명}
         ↓
Step 4: 구현 중간점검 — gap-detector로 갭 분석
         ↓
Step 5: 품질 검수 — code-analyzer로 코드 품질 확인
         ↓
Step 6: 완료 보고 — /pdca report {기능명}

5-3. 에이전트 호출 방법

에이전트는 자연어로 자동 트리거된다:

"이 사양서 검증해줘"        → design-validator 자동 실행
"구현이 사양서대로 됐어?"    → gap-detector 자동 실행
"코드 품질 분석해줘"        → code-analyzer 자동 실행
"완료 보고서 만들어줘"      → report-generator 자동 실행

---

Part 6: 실전 시나리오 모음

시나리오 1: 신규 캐릭터 밸런싱

나: "신규 캐릭터 '화염술사'를 추가하려고 해.
    기존 5개 클래스 스탯 테이블(CSV)이야.

    화염술사 컨셉:
    - 고화력 원거리 딜러
    - 체력 낮음
    - 범위 공격 특화

    기존 밸런스를 무너뜨리지 않는
    스탯 범위를 제안해줘"

시나리오 2: 이벤트 보상 설계

나: "7일 출석 이벤트 보상 테이블을 설계해줘.

    제약 조건:
    - 총 보상 가치: 유료 재화 1000원 상당 이하
    - 매일 갈수록 매력적인 보상
    - 7일차에 가장 큰 보상 (이탈 방지)
    - 게임 경제에 미치는 영향 분석 포함"

시나리오 3: A/B 테스트 결과 분석

나: "튜토리얼 A/B 테스트 결과야.

    그룹 A (기존): 1000명, 완료율 35%, D7 리텐션 18%
    그룹 B (신규): 1000명, 완료율 52%, D7 리텐션 22%

    통계적으로 유의미한 차이인지 검정해줘.
    신뢰구간 95% 기준으로."

시나리오 4: 컨텐츠 소비 속도 예측

나: "현재 컨텐츠 현황:
    - 메인 스토리: 50 챕터
    - 일일 퀘스트: 5종
    - 주간 보스: 3종
    - 이벤트: 격주 1회

    헤비 유저(일 4시간)와 라이트 유저(일 30분) 기준으로
    컨텐츠 소진까지 걸리는 시간을 예측해줘"

시나리오 5: 경쟁사 분석 프레임워크

나: "경쟁 RPG 3개의 가챠 시스템을 비교 분석할 프레임워크를 만들어줘.

    비교 항목:
    - 확률 체계
    - 천장 시스템
    - 무료 재화 수급량
    - 과금 효율성 (만원당 기대 SSR 수)

    엑셀 형태로 정리해줘"

---

부록 A: 기획자를 위한 프롬프트 모음

사양서 관련

# 기획서 작성
"XXX 시스템 기획서를 작성해줘. 유저 스토리, 기능 요구사항, 우선순위를 포함해줘"

# 사양서 검증
"이 사양서에 누락된 항목이나 모순되는 부분을 찾아줘"

# 기술사양서 변환
"이 기획서를 개발팀이 바로 작업할 수 있는 기술사양서로 변환해줘"

# 사양서 비교
"v1 사양서와 v2 사양서의 차이점을 정리해줘"

데이터 분석 관련

# 기본 분석
"이 CSV 데이터의 기본 통계와 분포를 보여줘"

# 이상치 감지
"이 데이터에서 비정상적인 값이나 패턴을 찾아줘"

# 상관 분석
"플레이 시간, 레벨, 과금액 사이의 상관관계를 분석해줘"

# 코호트 분석
"가입 월별 코호트의 리텐션 커브를 그려줘"

밸런싱 관련

# 수치 설계
"레벨 1~N의 성장 테이블을 만들어줘. 조건: ..."

# 확률 검증
"이 확률표를 N만 회 시뮬레이션으로 검증해줘"

# 경제 분석
"재화 유입/유출 데이터로 인플레이션 시뮬레이션을 돌려줘"

# 밸런스 체크
"이 클래스별 스탯으로 DPS/EHP를 계산해서 밸런스를 확인해줘"

시각화 관련

# 단일 차트
"XXX 데이터를 [막대/선/파이/히트맵] 차트로 그려줘"

# 대시보드
"이 데이터셋으로 인터랙티브 HTML 대시보드를 만들어줘"

# Google Sheets 연동
"Google Sheets의 'XXX' 시트 데이터를 읽어서 분석해줘"

---

부록 B: 트러블슈팅

자주 겪는 문제와 해결법

문제	원인	해결
“CSV를 읽을 수 없어요”	파일 경로가 잘못됨	절대 경로 또는 상대 경로 확인
“차트가 안 나와요”	Python/matplotlib 미설치	pip install matplotlib pandas 실행
“Google Sheets 연결 안 됨”	인증 미설정	서비스 계정 키 파일 설정 필요
“시뮬레이션이 너무 느려요”	시뮬레이션 횟수 과다	1만~10만 회 수준으로 조정

효과적인 요청의 핵심

1. 구체적인 숫자를 포함하라 — “밸런싱해줘” ❌ → “HP 5000, ATK 300 기준으로 DPS를 계산해줘” ✅
2. 출력 형식을 지정하라 — “분석해줘” ❌ → “CSV와 막대 차트로 보여줘” ✅
3. 제약 조건을 명시하라 — “보상 만들어줘” ❌ → “총 가치 1000원 이하, 7일 출석 기준” ✅
4. 비교 기준을 제시하라 — “이거 괜찮아?” ❌ → “D7 리텐션 20% 기준으로 개선됐는지 확인해줘” ✅

---

마무리

Claude Code는 기획자의 업무를 대체하는 도구가 아니라, 기획자의 판단을 데이터로 뒷받침하는 도구다.

• 사양서: 구조화와 검증을 자동화하되, 기획 의도는 기획자가 결정한다
• 데이터: 분석과 시각화를 자동화하되, 해석과 의사결정은 기획자의 몫이다
• 밸런싱: 시뮬레이션과 계산을 자동화하되, 재미의 기준은 기획자가 정한다

Claude는 완벽하지 않습니다. 중요한 수치와 결정은 반드시 직접 확인하세요.