Claude Setting

Claude Code 환경 설정 파일 저장소

Quick Start

macOS / Linux (Bash)

# 1. Clone
git clone https://github.com/mochunab/claude_setting.git ~/claude_setting

# 2. 설정 파일 복사
cp ~/claude_setting/claude/CLAUDE.md ~/.claude/CLAUDE.md
cp ~/claude_setting/claude/settings.json ~/.claude/settings.json
cp -r ~/claude_setting/claude/agents ~/.claude/agents
cp -r ~/claude_setting/claude/rules ~/.claude/rules
cp -r ~/claude_setting/claude/skills ~/.claude/skills
cp -r ~/claude_setting/claude/hooks ~/.claude/hooks
cp -r ~/claude_setting/claude/docs ~/.claude/docs

# 3. hooks 실행 권한
chmod +x ~/.claude/hooks/*.sh

# 4. permissions 설정 (예시 복사 후 필요에 맞게 수정)
cp ~/claude_setting/claude/settings.local.example.json ~/.claude/settings.local.json
# MCP 서버, API 키 등은 settings.local.json에서 직접 설정

Windows (PowerShell)

git clone https://github.com/mochunab/claude_setting.git $env:USERPROFILE\claude_setting
Copy-Item $env:USERPROFILE\claude_setting\claude\CLAUDE.md $env:USERPROFILE\.claude\CLAUDE.md
Copy-Item $env:USERPROFILE\claude_setting\claude\settings.json $env:USERPROFILE\.claude\settings.json
Copy-Item -Recurse $env:USERPROFILE\claude_setting\claude\agents $env:USERPROFILE\.claude\agents
Copy-Item -Recurse $env:USERPROFILE\claude_setting\claude\rules $env:USERPROFILE\.claude\rules
Copy-Item -Recurse $env:USERPROFILE\claude_setting\claude\skills $env:USERPROFILE\.claude\skills
Copy-Item -Recurse $env:USERPROFILE\claude_setting\claude\hooks $env:USERPROFILE\.claude\hooks
Copy-Item -Recurse $env:USERPROFILE\claude_setting\claude\docs $env:USERPROFILE\.claude\docs
# 4. permissions 설정 (예시 복사 후 필요에 맞게 수정)
Copy-Item $env:USERPROFILE\claude_setting\claude\settings.local.example.json $env:USERPROFILE\.claude\settings.local.json
# MCP 서버, API 키 등은 settings.local.json에서 직접 설정

---

File Structure

claude_setting/
├── claude/
│   ├── CLAUDE.md                      # 글로벌 개발 원칙 (모든 프로젝트 자동 적용)
│   ├── settings.json                  # 플러그인 + 훅 + 권한
│   ├── settings.local.example.json    # permissions 예시 (복사 후 settings.local.json으로 사용)
│   │
│   ├── rules/                         # 글로벌 룰 (매 세션 자동 적용)
│   │   ├── security.md                #   보안 원칙
│   │   ├── performance.md             #   성능 원칙
│   │   ├── testing.md                 #   테스트 원칙
│   │   └── agent-chaining.md          #   에이전트 체이닝 규칙
│   │
│   ├── hooks/                         # 글로벌 안전 훅 + 프로젝트용 템플릿
│   │   ├── block-dangerous.sh         #   파괴적 명령 차단 (PreToolUse)
│   │   ├── protect-files.sh           #   민감 파일 보호 (PreToolUse)
│   │   ├── lint-changed.sh            #   린트 자동 실행 템플릿 (프로젝트별 적용)
│   │   ├── caveman-activate.js        #   Caveman 모드 활성화 훅
│   │   ├── caveman-mode-tracker.js    #   Caveman 모드 상태 추적
│   │   ├── caveman-stats.js           #   Caveman 토큰 사용량 통계
│   │   ├── caveman-statusline.sh      #   Caveman 상태줄 (macOS/Linux)
│   │   ├── caveman-statusline.ps1     #   Caveman 상태줄 (Windows)
│   │   └── caveman-config.js          #   Caveman 설정
│   │
│   ├── agents/                        # 글로벌 에이전트 (8개)
│   │   ├── code-searcher.md
│   │   ├── deploy-checker.md
│   │   ├── edge-function-dev.md
│   │   ├── qa-tester.md
│   │   ├── ui-reviewer.md
│   │   ├── content-planner.md
│   │   ├── feature-planner.md
│   │   └── growth-strategist.md
│   │
│   │
│   ├── skills/                        # 스킬 (36개)
│   │   ├── ui-ux-pro-max/             #   UI/UX 디자인 (67 styles, 96 palettes)
│   │   ├── supanova-design-engine/    #   프리미엄 랜딩페이지 생성
│   │   ├── supanova-premium-aesthetic/#   $150k 에이전시 미학
│   │   ├── supanova-redesign-engine/  #   기존 페이지 업그레이드
│   │   ├── supanova-full-output/      #   AI 출력 생략 방지
│   │   ├── web-design-guidelines/     #   웹 디자인 원칙
│   │   ├── accessibility-a11y/        #   WCAG 접근성 심층 검사
│   │   ├── tailwindcss-advanced-layouts/ # Tailwind 고급 레이아웃
│   │   ├── hue/                       #   레퍼런스 URL → 디자인 시스템 스킬 자동 생성
│   │   ├── taste-skill/               #   Taste 메인 — 미학 오케스트레이션
│   │   ├── minimalist-skill/          #   Taste — Notion/Linear 에디토리얼 UI
│   │   ├── brutalist-skill/           #   Taste — 스위스 타이포, 실험적 레이아웃
│   │   ├── brandkit/                  #   Taste — 브랜드킷 생성
│   │   ├── imagegen-frontend-web/     #   Taste — 웹 UI 이미지 생성
│   │   ├── imagegen-frontend-mobile/  #   Taste — 모바일 UI 이미지 생성
│   │   ├── image-to-code-skill/       #   Taste — 이미지 → 코드 변환
│   │   ├── stitch-skill/              #   Taste — 컴포넌트 조합
│   │   ├── design-explore/            #   디자인 방향 탐색 — N개 변형 병렬 생성, 비교 보드, 피드백 루프
│   │   ├── frontend-patterns/         #   React/Next.js 패턴
│   │   ├── coding-standards/          #   TS/JS/React 코딩 표준
│   │   ├── backend-patterns/          #   Node.js/API 아키텍처
│   │   ├── postgres-patterns/         #   PostgreSQL 최적화 (Supabase)
│   │   ├── clickhouse-io/             #   ClickHouse 분석 DB
│   │   ├── security-review/           #   보안 체크리스트
│   │   ├── tdd-workflow/              #   TDD 워크플로우
│   │   ├── trend/                     #   멀티 플랫폼 트렌드 서칭
│   │   ├── gemini-web-fetch/          #   WebFetch 폴백 (Gemini)
│   │   ├── find-skills/               #   스킬 검색/설치
│   │   ├── privacy-terms/             #   처리방침·이용약관 자동 생성 (진입점)
│   │   ├── privacy-kr/                #   한국 PIPA 처리방침·약관
│   │   ├── privacy-eu/                #   EU GDPR Privacy Notice·Terms
│   │   ├── caveman/                   #   Caveman 모드 (토큰 75% 절감)
│   │   ├── caveman-commit/            #   Caveman 커밋 메시지 생성기
│   │   ├── caveman-compress/          #   Caveman 메모리 파일 압축
│   │   ├── caveman-help/              #   Caveman 도움말
│   │   ├── caveman-review/            #   Caveman 코드 리뷰
│   │   └── caveman-stats/             #   Caveman 세션 통계
│   │
│   └── docs/                          # 사람용 레퍼런스 (Claude 자동 탐색 대상 아님)
│       ├── 개발/
│       │   ├── HOOKS_STRATEGY.md      #   Hook 전략서 + 프로젝트별 적용 가이드
│       │   ├── CLAUDE_SETUP_STRATEGY.md
│       │   ├── HARNESS_ENGINEERING.md
│       │   ├── TOKEN_OPTIMIZATION.md
│       │   ├── PERFORMANCE_OPTIMIZATION.md
│       │   ├── SECURITY.md
│       │   ├── ONTOLOGY_GUIDE.md
│       │   ├── APP_LAUNCH_CHECKLIST.md
│       │   ├── DESIGN_SYSTEM_WORKFLOW.md
│       │   └── USABILITY_TESTING.md
│       ├── 비즈니스/
│       │   ├── UNIVERSAL_GROWTH_FORMULA.md
│       │   ├── AARRR_FUNNEL_STRATEGY.md
│       │   └── PM_FRAMEWORKS.md
│       ├── 마케팅/
│       │   ├── VIRAL_FEATURE_STRATEGY.md
│       │   ├── SEO_전략서.md
│       │   ├── GA_전략서.md
│       │   └── 스타트업_마케팅_구조_전략서.md
│       ├── 콘텐츠/
│       │   ├── VIRAL_CONTENT_MAKING_STRATEGY.md
│       │   ├── VIRAL_GROWTH_PLAYBOOK.md
│       │   └── ZALPHA_CHARACTER_GUIDE.md
│       └── 데이터 분석/              #   통계·실험설계·프로덕트분석·SQL·Python (11챕터)
└── README.md

---

레이어 구조

rules/          매 세션 자동 로드     Claude가 반드시 따르는 코딩 규칙
hooks/          도구 사용 시 자동 실행  안전장치 (차단/보호) + 품질 자동화 (린트)
agents/         명시적 호출            전문 작업 수행 (배포 점검, UI 리뷰, 기획)
skills/         키워드 트리거          특정 주제 감지 시 자동 활성화
docs/           사람이 직접 열람       Claude 자동 탐색 대상 아님 (에이전트가 명시 참조만)

---

Hooks (안전장치)

글로벌 (모든 프로젝트 자동 적용)

Hook	이벤트	역할
block-dangerous.sh	PreToolUse: Bash	rm -rf, git reset --hard, git push --force (force-with-lease 허용), DROP TABLE 등 차단
protect-files.sh	PreToolUse: Edit|Write	.env, .git/, lock 파일, .pem, .key, secrets/ 수정 차단

Caveman 훅

Hook	역할
caveman-activate.js	Caveman 모드 활성화 (UserPromptSubmit)
caveman-mode-tracker.js	모드 상태 추적
caveman-stats.js	토큰 사용량 통계 수집
caveman-statusline.sh	상태줄 표시 (macOS/Linux)
caveman-statusline.ps1	상태줄 표시 (Windows)
caveman-config.js	Caveman 설정 관리

프로젝트별 (템플릿 제공)

Hook	이벤트	역할
lint-changed.sh	PostToolUse: Edit|Write	변경된 파일에 ESLint 자동 실행. 프로젝트에 ESLint 없으면 통과

프로젝트별 적용법은 docs/개발/HOOKS_STRATEGY.md 참조.

---

Rules (자동 적용 — 3개)

Rule	역할
security.md	시크릿 관리, 입력검증, 에러처리, CORS, 인시던트 대응
performance.md	미들웨어 경량화, 캐시 레이어, 병렬화, staleTimes, 로딩 전략
testing.md	테스트 작성 기준, 단위/통합/E2E, mock 정책, 테스트 구조
agent-chaining.md	에이전트 체이닝 — 범용 개발/Edge Function/UI/비즈니스/실패 복구 체인, 컨텍스트 전달 형식

---

Agents (8개)

개발 에이전트

Agent	용도	트리거
code-searcher	코드베이스 탐색, 영향도 분석	"찾아줘", "어디서", "영향도"
deploy-checker	배포 전 빌드/보안/환경변수 점검	"배포 전 점검", "프로덕션 체크"
edge-function-dev	Supabase Edge Function 개발/디버깅	Edge Function 관련 작업
qa-tester	Playwright MCP 기반 브라우저 QA 테스트	"QA", "테스트", "점검"
ui-reviewer	UI/디자인 리뷰 (스킬 자동 라우팅)	"UI 검사", "디자인 체크"

비즈니스 에이전트

Agent	용도	참조 문서
content-planner	바이럴 콘텐츠 기획 — 감정 설계, 훅 카피, CTA	docs/콘텐츠/
feature-planner	바이럴 기능/제품 설계 — 심리 트리거, 공유 루프	docs/마케팅/, docs/비즈니스/
growth-strategist	사업 성장 전략 — 본능 분석, AARRR 퍼널	docs/비즈니스/

ui-reviewer 스킬 라우팅

ui-reviewer는 요청 유형에 따라 보유 디자인 스킬을 자동 선택하여 리뷰합니다:

요청 유형	적용 스킬
랜딩페이지 신규	supanova-design-engine
리디자인	supanova-redesign-engine
프리미엄 미학	supanova-premium-aesthetic
완전 출력 검증	supanova-full-output
일반 UI/UX	ui-ux-pro-max (기본)
웹 디자인 가이드라인	web-design-guidelines
접근성 심층 검사	accessibility-a11y
Tailwind 고급 레이아웃	tailwindcss-advanced-layouts
미니멀/에디토리얼 UI	minimalist-skill
실험적/브루탈리스트 UI	brutalist-skill
미학 방향 오케스트레이션	taste-skill
브랜드킷 생성	brandkit
웹 UI 레퍼런스 이미지	imagegen-frontend-web
모바일 UI 레퍼런스 이미지	imagegen-frontend-mobile
디자인 시스템 생성	hue
이미지 → 코드 변환	image-to-code-skill
디자인 방향 탐색	design-explore
React/Next.js	frontend-patterns

---

Skills (36개)

디자인 (17개)

Skill	용도
ui-ux-pro-max	UI/UX 디자인 인텔리전스 (67 styles, 96 palettes, 57 font pairings, 13 stacks)
supanova-design-engine	프리미엄 랜딩페이지 생성 (Tailwind CDN, 한국어 퍼스트)
supanova-premium-aesthetic	$150k 에이전시 수준 미학 — Double-Bezel 카드, 스프링 모션, 안티패턴 차단
supanova-redesign-engine	기존 랜딩페이지 진단 후 프리미엄 업그레이드
supanova-full-output	AI 출력 생략 방지 — 플레이스홀더/스켈레톤 차단, 완전한 HTML 강제
web-design-guidelines	Vercel 공식 웹 디자인 원칙 — 타이포, 컬러, 스페이싱, 레이아웃 기준
accessibility-a11y	웹 접근성 심층 검사 — WCAG, 스크린리더, 키보드, ARIA
tailwindcss-advanced-layouts	Tailwind 고급 레이아웃 — CSS Grid, 비대칭, 복잡한 반응형 패턴
hue	메타 스킬 — 레퍼런스 URL/브랜드명 → 디자인 시스템 스킬 자동 생성 (1회 생성 → 영구 재사용)
taste-skill	Taste 메인 — 미학 방향 오케스트레이션
minimalist-skill	Taste — Notion/Linear 스타일 에디토리얼 UI (절제된 색상, 명확한 구조)
brutalist-skill	Taste — 스위스 타이포그래피, 강한 명도 대비, 실험적 레이아웃
brandkit	Taste — 브랜드킷 생성
imagegen-frontend-web	Taste — 웹 UI 레퍼런스 이미지 생성
imagegen-frontend-mobile	Taste — 모바일 UI 레퍼런스 이미지 생성
image-to-code-skill	Taste — 이미지/스크린샷 → 코드 변환
design-explore	디자인 방향 탐색 — N개 변형 병렬 생성, HTML 비교 보드, 피드백 루프 (gstack design-shotgun 경량 재구현)

프론트엔드 (2개)

Skill	용도
frontend-patterns	React, Next.js 컴포넌트/상태관리/퍼포먼스 패턴
coding-standards	TypeScript/JavaScript/React/Node.js 코딩 표준

백엔드/DB (3개)

Skill	용도
backend-patterns	Node.js/Express/Next.js API 아키텍처, DB 최적화
postgres-patterns	PostgreSQL 쿼리 최적화, 스키마 설계, 인덱싱, 보안 (Supabase 기반)
clickhouse-io	ClickHouse 분석 DB 패턴, 쿼리 최적화, 데이터 엔지니어링

보안/테스트 (2개)

Skill	용도
security-review	인증, 입력검증, 시크릿, API, 결제 보안 체크리스트
tdd-workflow	TDD 워크플로우 — 80%+ 커버리지, 단위/통합/E2E 테스트

콘텐츠/마케팅 (1개)

Skill	용도
trend	멀티 플랫폼 트렌드 서칭 (X, 인스타, 스레드, 틱톡, 유튜브, 레딧)

법률/컴플라이언스 (3개)

Skill	용도
privacy-terms	처리방침·이용약관 자동 생성 진입점 — 관할법별 하위 스킬 자동 분기
privacy-kr	한국 PIPA 개인정보처리방침·이용약관·동의 모달·쿠키 배너 생성 (2026.3 개정법 반영)
privacy-eu	EU GDPR Privacy Notice·Terms of Service·Consent Modal·Cookie Banner 생성

Caveman (6개)

Skill	용도
caveman	토큰 75% 절감 모드 (lite/full/ultra/wenyan 6단계)
caveman-commit	압축형 커밋 메시지 생성기
caveman-compress	메모리/설정 파일 caveman 포맷 압축
caveman-help	Caveman 모드 퀵 레퍼런스
caveman-review	압축형 코드 리뷰 (1줄/이슈)
caveman-stats	세션 토큰 사용량/절감 통계

메타/유틸 (2개)

Skill	용도
find-skills	스킬 마켓에서 새 스킬 검색/설치
gemini-web-fetch	WebFetch 폴백 (Gemini 활용)

---

Plugins (6개)

Plugin	역할
vercel	배포, CLI, Functions, AI SDK, shadcn, React best practices 등. 프로젝트 초기 세팅 시에만 활용 권장 — 구축된 프로젝트에서는 매 턴 ~20K+ 토큰을 소모하여 컨텍스트 압축이 가속되므로 비활성화 추천
supabase	DB 관리, Edge Functions, 마이그레이션
feature-dev	7단계 기능 개발 워크플로우 (탐색→설계→구현→리뷰)
pr-review-toolkit	PR 코드 리뷰 (6개 전문 에이전트)
serena	시맨틱 코드 분석 — LSP 기반 심볼 탐색, 리팩터링, 코드베이스 네비게이션
frontend-design	프리미엄 프론트엔드 생성

---

MCP Servers (10개)

프로젝트별 .mcp.json 또는 settings.local.json에서 설정. API 키 포함이므로 절대 git 커밋 금지.

MCP Server	프로토콜	용도
supabase	HTTP	DB SQL 실행, 테이블/마이그레이션 관리, Edge Function 배포, 문서 검색
playwriter	stdio (npx)	Playwright 래퍼 — QA 테스트 실행/리셋 (qa-tester 에이전트 연동)
figma	stdio	Figma 디자인 스크린샷 추출, 디자인 컨텍스트 조회
firecrawl	stdio	웹 페이지 스크래핑 (구조화된 데이터 추출)
apify	stdio	액터 검색 — 멀티 플랫폼 트렌드 서칭 (trend 스킬 연동)
korean-law	URL (SSE)	법제처 41개 API 통합 — 법령·판례·헌재결정 검색·분석
semble	stdio (user)	하이브리드 코드 검색 (BM25+시맨틱) — 토큰 93% 절감, 의존성/영향도 분석
serena	stdio (→ plugin)	LSP 기반 시맨틱 코드 분석 — 심볼 탐색, 참조 추적, 리팩터링
Zapier-MCP	HTTP (OAuth)	8,000+ SaaS 자동화 — Slack/Notion/Gmail/Jira 등 Zap 실행·조회
Gmail	HTTP (OAuth, Claude.ai 커넥터)	메일 검색·발송, 라벨/필터 관리, 자동 분류를 Claude에서 직접 수행

프로젝트별 .mcp.json 예시

{
  "mcpServers": {
    "playwriter": {
      "command": "npx",
      "args": ["-y", "playwriter@latest"],
      "env": { "PLAYWRITER_AUTO_ENABLE": "1" }
    }
  }
}

---

docs/ (사람용 레퍼런스)

Claude가 자동 탐색하지 않는 문서. 에이전트가 명시적 경로로 참조하거나, 사람이 직접 열람.

카테고리	파일	내용
개발	HOOKS_STRATEGY.md	Hook 전략서 + 프로젝트별 적용 가이드
개발	CLAUDE_SETUP_STRATEGY.md	.claude/ 폴더 구조 설계
개발	HARNESS_ENGINEERING.md	하네스 엔지니어링 방법론
개발	TOKEN_OPTIMIZATION.md	토큰 절약 전략
개발	PERFORMANCE_OPTIMIZATION.md	성능 최적화 확장판 (rules/ 보충)
개발	SECURITY.md	보안 가이드 확장판 (rules/ 보충)
개발	ONTOLOGY_GUIDE.md	온톨로지 설계 가이드
개발	APP_LAUNCH_CHECKLIST.md	앱 런칭 체크리스트
개발	DESIGN_SYSTEM_WORKFLOW.md	디자인 시스템 워크플로우
개발	USABILITY_TESTING.md	사용성 테스트 가이드
비즈니스	UNIVERSAL_GROWTH_FORMULA.md	5단계 성장 엔진 (본능→훅→확산→전환→잠금)
비즈니스	AARRR_FUNNEL_STRATEGY.md	AARRR 퍼널 설계 + 단계별 지표
비즈니스	PM_FRAMEWORKS.md	PM 프레임워크 8종
마케팅	VIRAL_FEATURE_STRATEGY.md	바이럴 기능 설계 + 26개 케이스 스터디
마케팅	SEO_전략서.md	SEO 체크리스트 + 기술적/콘텐츠 SEO
마케팅	GA_전략서.md	GA4 이벤트 설계 + 퍼널 분석
마케팅	스타트업_마케팅_구조_전략서.md	스타트업 마케팅 구조 설계
콘텐츠	VIRAL_CONTENT_MAKING_STRATEGY.md	감정 설계, 8대 훅, 9개 카피 패턴
콘텐츠	VIRAL_GROWTH_PLAYBOOK.md	바이럴 삼각형, 논란 설계, 밈 생산성
콘텐츠	ZALPHA_CHARACTER_GUIDE.md	Z/Alpha 세대 캐릭터 디자인 가이드
데이터 분석	00_목차.md ~ 10_부록.md	통계기초·실험설계·프로덕트분석·SQL심화·Python분석 등 11개 챕터

---

Configuration

settings.json

글로벌 설정 — hooks, 플러그인, 기본 모드

settings.local.example.json

permissions 예시 파일. 복사 후 settings.local.json으로 사용:

• defaultMode: "acceptEdits" — Edit/Write 자동 허용, Bash는 허용 목록 기반
• Bash 허용: git, gh, node, npm, brew, supabase, vercel 등 개발 도구
• MCP 허용: supabase, playwriter, firecrawl, apify, serena, Zapier-MCP
• WebFetch 허용: docs.anthropic.com, github.com 등

settings.local.json

기기별 로컬 설정 — permissions + MCP 서버 + API 키. 절대 git 커밋 금지.