클로드 코드 100% 활용 지식체계
— 수익화·자동화를 위한 운영 플레이북

EXECUTIVE SUMMARY

결론부터: 바꿔야 할 것은 3가지입니다

00 · 현황 스캔

ONOFFERDEV GitHub 조직 실측 — 우리는 어디에 있나

2026-08-08, GitHub CLI로 조직 전체를 실측한 결과입니다. 결론부터: 개발자 쪽에는 이미 무인 자동화 인프라(Lv4)가 여럿 돌아가고 있고, 격차는 "기술"이 아니라 "팀 표준화와 자산의 이원화"에 있습니다.

구성원 — 누가 무엇을 만들고 있나 (커밋 실측)

저장소 도메인 지도 — 5개 영역 상세

이미 구축된 자동화 인프라 (개발자측)

격차 진단 — 그래서 무엇이 문제인가

조직 수준 종합 평가 — 스코어카드

같은 규모(3인)의 이커머스 회사를 기준선으로, 실측 근거만으로 평가한 결과입니다.

01 · 진단

"어설프게 썼다"의 정체 — 활용 성숙도 5단계

클로드 코드 활용 수준은 아래 5단계로 나뉩니다. 대부분의 사용자는 Lv1~2에 머뭅니다. 온오퍼는 인물별 편차가 큽니다 — 0장 실측대로 개발자는 이미 Lv4(무인 데몬·자동화 킷)이고, 대표는 Lv2~3(ECC 설치, 로컬 도구 30여 개, 뉴스봇 1건), 마케터는 Lv0~1입니다. 이 보고서의 목표는 90일 안에 Lv4를 특정 개인이 아닌 팀 전체의 기본값으로 만드는 것입니다.

02 · 핵심 원리

컨텍스트 계층 구조 — 무엇을 어디에 담을 것인가

클로드 코드의 모든 커스터마이징 수단(CLAUDE.md, rules, 스킬, 에이전트, 훅, MCP)은 결국 "어떤 지식을 언제 AI 머릿속에 넣을 것인가"를 정하는 장치입니다. 항상 켜져 있는 지식은 비용(컨텍스트)을 계속 차지하고, 필요할 때만 로드되는 지식은 공짜에 가깝습니다. 이 구분이 전체 설계의 제1원리입니다.

판단 순서 (결정 트리)

파일 경로 지도 (치트시트)

# 개인 전역 (모든 프로젝트 공통)
~/.claude/CLAUDE.md              # 전역 원칙
~/.claude/settings.json          # 전역 설정·권한·훅
~/.claude/skills/이름/SKILL.md   # 개인 스킬
~/.claude/agents/이름.md         # 개인 에이전트
~/.claude/rules/*.md             # 전역 룰 (ECC가 여기 설치됨)

# 프로젝트 (git으로 팀 공유 — 8장)
./CLAUDE.md                      # 프로젝트 지식 (/init으로 생성)
./.claude/settings.json          # 팀 공유 설정 (커밋)
./.claude/settings.local.json    # 개인 오버라이드 (gitignore)
./.claude/skills/  ./.claude/agents/  ./.claude/rules/
./.mcp.json                      # 팀 공유 MCP 서버 (커밋)

# 자동 기록
~/.claude/projects/<저장소>/memory/MEMORY.md   # 자동 메모리
~/.claude/projects/<저장소>/sessions/          # 세션·체크포인트

03 · 기능 딥다이브

7가지 핵심 기능 — 실전 세팅법

3-1. CLAUDE.md & 메모리 — "매번 설명하지 않기"

새 프로젝트를 열면 무조건 /init을 먼저 실행하세요. 코드베이스를 분석해 CLAUDE.md 초안을 만들어 줍니다. 이후 작업 중 "이건 기억해"라고 말하면 자동 메모리에 저장됩니다. @파일경로 문법으로 다른 문서를 임포트할 수 있어, 프로젝트 CLAUDE.md에서 @~/.claude/shared-rules.md처럼 공용 규칙을 끌어올 수 있습니다.

3-2. 스킬 — "잘 된 작업을 슬래시 명령으로 굳히기"

가장 투자수익률이 높은 기능입니다. 폴더 하나 + 마크다운 하나면 끝납니다.

# .claude/skills/detail-report/SKILL.md
---
description: 쿠팡/네이버 상세페이지 분석 리포트. 상품 URL을 받으면 실행.
---
# 상세페이지 분석 리포트
$ARGUMENTS 의 상품 페이지를 분석해 다음 순서로 리포트를 작성한다:
1. 썸네일 후킹 요소 3가지 / 2. 상세 구조(스크롤 흐름) /
3. 리뷰 상위 불만 키워드 / 4. 우리 상품 대비 개선점 5가지
결과는 표 형식으로, 마지막에 실행 우선순위를 매긴다.

이제 누구든 /detail-report https://쿠팡주소 한 줄로 같은 품질의 리포트를 얻습니다. 마케터 교육의 핵심이 바로 이것입니다 — 프롬프트를 가르치는 게 아니라, 팀 스킬 라이브러리를 함께 만드는 것.

3-3. 서브에이전트 — "전문가를 고용하고 모델 단가까지 지정"

# .claude/agents/review-scanner.md
---
description: 리뷰 대량 수집·요약 전문. 리뷰 분석 요청 시 사용.
tools: Read, Bash, WebFetch
model: haiku          # 단순 대량작업은 저렴한 모델로
---
너는 이커머스 리뷰 분석가다. 리뷰를 수집해 불만/칭찬 키워드
상위 10개와 대표 문장만 간결히 보고한다.

서브에이전트는 별도 컨텍스트에서 돌고 요약만 돌아오므로, 본 세션이 지저분해지지 않습니다. 대량·단순 작업엔 model: haiku를 지정해 비용을 크게 낮추는 것이 정석입니다(9장).

3-4. 훅 — "AI의 선의가 아니라 시스템으로 강제"

훅은 LLM의 판단과 무관하게 무조건 실행되는 셸 명령입니다. "커밋 전에 꼭 테스트 돌려줘"라고 CLAUDE.md에 써도 가끔 빠뜨리지만, 훅은 절대 빠뜨리지 않습니다.

// settings.json — 예: 편집 후 자동 포맷 + 위험 명령 차단
{ "hooks": {
    "PostToolUse": [{ "matcher": "Edit|Write",
      "hooks": [{ "type": "command", "command": "npx prettier --write \"$file\"" }] }],
    "PreToolUse": [{ "matcher": "Bash",
      "hooks": [{ "type": "command", "command": "~/.claude/hooks/block-danger.sh" }] }]
} }

3-5. MCP — "외부 시스템을 손발로 연결"

claude mcp add --scope project github https://mcp.github.com/github-mcp
claude mcp add playwright -- npx -y @playwright/mcp@latest
claude mcp list     # 연결 상태 확인 / 세션 안에서는 /mcp

온오퍼는 이미 Slack·Gmail·캘린더·Chrome·자체 커머스 MCP(parameat-commerce)를 씁니다. 다음 후보는 GitHub MCP(개발자 협업)와 DB MCP(pinset·재고 데이터 직접 조회)입니다. 팀 공용 서버는 .mcp.json에 넣어 git으로 공유하되, API 키는 절대 커밋하지 않습니다(환경변수로).

3-6. 플랜 모드 · 권한 모드 — "큰 일은 계획부터, 반복 일은 승인 없이"

• Shift+Tab으로 모드 전환: default(모두 확인) → acceptEdits(파일 수정 자동승인) → dontAsk(대부분 자동).
• 큰 리팩토링·신규 기능은 플랜 모드로 계획을 먼저 받아 검토 후 실행 — 잘못된 방향으로 파일을 고치는 낭비를 없앱니다.
• 자동화 스크립트에는 --permission-mode acceptEdits --allowedTools "Read,Edit,Bash(npm run *)"처럼 허용 도구를 명시적으로 좁혀서 무인 실행합니다.

3-7. 체크포인트 · 세션 — "실험을 두려워하지 않기"

• /rewind(또는 Esc Esc): 사용자 메시지 직전 상태로 코드·대화를 되돌립니다. 과감한 실험 후 실패하면 즉시 복구.
• /resume: 지난 세션 목록에서 골라 이어서 작업. /branch로 세션을 분기해 A/B 접근을 병행.
• 주의: Bash로 바꾼 파일과 서브에이전트의 수정은 rewind로 복구되지 않습니다. 중요한 시점엔 git 커밋이 여전히 정답입니다.

04 · 자동화

자동화 사다리 — 대화에서 무인 파이프라인까지

수익화·자동화의 실체는 이 장입니다. 같은 작업이라도 어느 단(段)에서 실행하느냐에 따라 사람의 시간이 100%에서 0%가 됩니다.

헤드리스 모드 — 자동화의 엔진

# 파이프에 끼워 넣기
cat 주문내역.csv | claude -p "이상 주문 패턴 요약" > report.txt

# JSON으로 받아서 다른 프로그램에 연결
claude -p "이 리뷰들의 감정 분류" --output-format json | jq '.result'

# 무인 실행 (권한·도구를 좁혀서 안전하게)
claude -p "재고 리포트 생성 후 슬랙 발송" \
  --permission-mode acceptEdits \
  --allowedTools "Read,Bash(node *)"

여기에 맥의 launchd(뉴스봇이 이미 이 방식)나 클라우드 루틴(/schedule 명령, claude.ai/code/routines — 맥이 꺼져 있어도 Anthropic 인프라에서 실행)을 걸면 4단이 완성됩니다. 루틴은 스케줄 외에 API 트리거·GitHub 이벤트로도 발동돼, "에러 알림 → 자동 수정 PR" 같은 반응형 자동화도 가능합니다.

05 · 하네스

ECC 하네스 — 깔아둔 것의 10%만 쓰고 있다

ECC(에이전트 67 · 스킬 281 · 커맨드 94)는 이미 설치돼 있지만, 방대해서 오히려 안 쓰게 됩니다. 전부 알 필요 없습니다. 아래 큐레이션만 팀 습관으로 만들면 충분합니다.

06 · 수익화 플레이북

온오퍼 자산 × 자동화 사다리 매핑

이미 만들어 둔 도구 30여 개가 최고의 출발점입니다. 각 자산을 사다리 위 칸으로 올리는 것이 곧 수익화입니다.

신규 수익화 기회 (팀이 갖춰지면)

07 · 조직

3인 팀 운영 설계 — 역할·리듬·교육

핵심 원칙: 대표님은 지시하고, 개발자는 인프라를 만들고, 마케터는 운영하며 배웁니다. 세 사람이 같은 하네스 표준 위에서 일하되 책임은 겹치지 않게 설계합니다.

대표 오케스트레이터 — 방향과 우선순위

• 주간 자동화 백로그 관리: "이번 주 가장 반복된 수작업"을 골라 자동화 대상으로 지정.
• 결과물 검수 기준 소유: 스킬이 뱉는 리포트의 품질 기준을 정하고 피드백은 스킬 파일 수정으로 반영시킴.
• 비용 관제: /usage·/ecc:cost-report로 주간 사용량 리뷰 (9장).

풀스택 개발자 하네스 오너 — 플랫폼 엔지니어로 격상

가장 중요한 인사적 결정입니다. 개발자의 역할을 "기능 구현자"에서 "팀 전체의 AI 생산성 인프라 소유자"로 재정의하세요.

마케터 AI 운영자 — 4주 커리큘럼

공대 출신이라는 점이 큰 자산입니다. 목표는 "프롬프트 잘 쓰는 사람"이 아니라 "스킬을 만들고 자동화를 운영하는 사람"입니다.

주간 리듬 (30분 회고가 하네스를 키운다)

• 매주 금요일 30분 "자동화 회고": ① 이번 주 반복 수작업 1개 지목 → 다음 주 자동화 백로그에 ② 각자 만든 스킬 공유 ③ 실패 사례 → /ecc:hookify로 훅 후보화.
• 스킬 리뷰는 코드 리뷰처럼: 팀 저장소에 PR로 올리고 개발자가 승인. 스킬 품질 = 팀 산출물 품질.
• 월 1회 하네스 정비: 개발자가 안 쓰는 스킬 정리, ECC 업데이트, 비용 리포트 공유.

08 · 표준화

팀 배포 — 하네스를 git에 태우는 법

개인 아이맥의 설정을 팀 표준으로 만드는 구체적 방법입니다. 원리는 하나: 공유할 것은 프로젝트 .claude/에 커밋, 개인 취향은 settings.local.json(gitignore)에.

# 팀 하네스 저장소 (onoffer-harness) 구조 — 개발자가 구축
onoffer-harness/
├── CLAUDE.md                  # 회사 공통 원칙 (한국어, 200줄 이내)
├── .claude/
│   ├── settings.json          # 권한 allow/deny + 필수 훅 (커밋)
│   ├── skills/                # 팀 스킬 라이브러리 ← 회사의 핵심 자산
│   │   ├── detail-report/  ├── sourcing/  └── weekly-pnl/
│   ├── agents/                # review-scanner, security-check ...
│   ├── rules/                 # 코딩 표준 (경로 스코프)
│   └── hooks/                 # 백업·차단 스크립트
└── .mcp.json                  # 팀 공용 MCP (키는 환경변수로!)

• 배포 방법: 각자 이 저장소를 클론하고, 개인 ~/.claude/CLAUDE.md에서 @~/onoffer-harness/CLAUDE.md로 임포트하거나, 프로젝트별 심볼릭 링크. 업데이트는 git pull 한 번.
• 권한 표준: settings.json의 permissions.deny에 Bash(sudo *), Read(.env*) 등을 팀 공통으로 박아두면 전원에게 안전벨트가 채워집니다.
• 더 크게 갈 때: 팀이 커지면 저장소를 플러그인(plugin.json)으로 포장해 사내 마켓플레이스로 배포하는 것이 정석입니다. 기존 팀 가이드(ecc-team-setup.pages.dev)와 이 저장소를 연결하세요.

09 · 비용

비용·모델 전략 — 품질은 유지하고 단가만 낮추기

• 컨텍스트가 곧 돈: 작업이 바뀌면 /clear, 길어지면 /compact. 대형 리팩토링은 컨텍스트 마지막 20% 구간에서 시작하지 않기.
• 관측: /usage(플랜 한도), /ecc:cost-report(ECC 로컬 리포트), 이미 구축한 쿼터 상태줄로 5시간/주간 한도 상시 확인.
• 무인 파이프라인은 반드시 저가 모델 + 좁은 도구 권한으로 — 사람이 지켜보지 않는 실행일수록 단가와 권한을 조입니다.

10 · 함정 & 로드맵

흔한 함정 8가지

90일 로드맵

11 · 대표의 실행 체계

조직 수준을 올리는 대표의 행동·지침·지식 체계

0장 평가의 결론은 "기술 A · 조직 D"였습니다. 기술은 개발자가 올리지만, 조직 등급(D→B)은 오직 대표만 올릴 수 있습니다. 코드를 몰라도 됩니다 — 대표의 레버는 처음부터 끝까지 결정, 요구, 리듬 세 가지입니다.

대표의 3가지 레버

운영 리듬 — 대표의 캘린더

지시 프로토콜 — "부탁"을 "자산 주문"으로 바꾸는 문장법

대표의 지시 문장이 조직의 자산화 속도를 결정합니다. 모든 지시에 3요소를 붙이세요: ①산출물 정의 ②재사용 형태 ③완료 기준.

하지 말아야 할 것 — 대표의 안티패턴 4

대표의 지식 체계 — 무엇을 알아야 하고, 무엇은 몰라도 되나

학습 방법은 지금처럼: 대표님이 이미 하고 있는 "직접 도구를 만들어보는 것"이 최고의 학습입니다. 딱 두 가지만 바꾸세요 — 만들면 ONOFFERDEV에 올릴 것, 그리고 매번 이 보고서의 결정 트리(2장)로 "이건 스킬로 남길 일인가"를 자문할 것.

이번 달 결정 리스트 — 대표만 할 수 있는 결정 6

대표의 대시보드 — 매주 이 4개 숫자만 보면 됩니다