Claude Code를 구조화된 개발 플랫폼으로 변환하는 메타 프로그래밍 프레임워크
터미널에서 아래 명령어를 실행하세요:
Python 3.10 이상 필요
pipx install superclaude
superclaude install
superclaude doctor
pipx upgrade superclaude && superclaude install --force 실행
# PM 모드 시작 (보통 자동 활성화) /sc:pm # 브레인스토밍 전략으로 시작 /sc:pm "인증 시스템 설계해줘" --strategy brainstorm # 웨이브 전략으로 대규모 작업 /sc:pm "보안 감사 전체 실행" --strategy wave
# 명령어 추천 받기 /sc:recommend "로그인 기능 구현하고 싶어" # 시간 예측 포함 /sc:recommend "API 문서화" --estimate # 대안 제시 /sc:recommend "성능 최적화" --alternatives
# 기본 리서치 /sc:research "Next.js 14 App Router 베스트 프랙티스" # 깊이 있는 리서치 /sc:research "React 상태관리 비교" --depth deep # 철저한 리서치 /sc:research "Docker 보안" --depth exhaustive --strategy unified
# 품질 분석 /sc:analyze --focus quality # 보안 심층 분석 /sc:analyze src/ --focus security --think-hard # 아키텍처 분석 (최대 깊이) /sc:analyze . --focus architecture --ultrathink
# 파일 설명 /sc:explain src/utils/auth.ts # 알고리즘 설명 /sc:explain "이 정렬 알고리즘이 어떻게 동작하는지" # 프로젝트 구조 설명 /sc:explain "이 프로젝트의 전체 구조"
# 빌드 오류 진단 /sc:troubleshoot "npm run build 실패" --type build --trace # 버그 수정 /sc:troubleshoot "TypeError: Cannot read property" --type bug --fix # 성능 문제 /sc:troubleshoot "API 응답이 느림" --type performance --seq
# 아키텍처 설계 /sc:design user-management --type architecture # API 설계 /sc:design payment-api --type api --format spec # 데이터베이스 설계 /sc:design e-commerce --type database --format diagram
# 기능 아이디어 도출 /sc:brainstorm "사용자 참여를 높일 수 있는 기능" # 기술 솔루션 탐색 /sc:brainstorm "대용량 파일 업로드 처리 방법" # 문제 해결 아이디어 /sc:brainstorm "API 응답 속도 개선 방안"
# PRD에서 워크플로우 생성 /sc:workflow docs/prd.md # 기능에서 작업 분해 /sc:workflow "사용자 인증 시스템 구현"
# 기능 시간 예측 /sc:estimate "사용자 대시보드 구현" # 전체 프로젝트 예측 /sc:estimate --scope project # 상세 분해 /sc:estimate "인증 시스템" --breakdown
# 백엔드 구현 /sc:implement "JWT 기반 인증 시스템" --type backend --focus security # 프론트엔드 + Magic UI /sc:implement "대시보드 컴포넌트" --type frontend --magic --c7 # 풀스택 구현 /sc:implement "사용자 CRUD REST API" --type fullstack --c7
# 안전한 리팩토링 (미리보기) /sc:improve src/services/ --type quality --safe --preview # 성능 최적화 (반복 개선) /sc:improve api/handlers/ --type performance --loop # 보안 강화 /sc:improve auth/ --type security --validate
# 기본 빌드 /sc:build # 프로덕션 빌드 /sc:build --production # 오류 자동 수정 /sc:build --fix-errors
# 안전한 코드 정리 /sc:cleanup src/ --type all --safe # 인터랙티브 정리 /sc:cleanup --type code --interactive # 적극적 정리 /sc:cleanup --type all --aggressive
# 전체 테스트 + 커버리지 /sc:test --coverage # 유닛 테스트만 /sc:test --type unit # E2E 테스트 (Playwright) /sc:test --type e2e --play # 워치 모드 /sc:test --watch --fix
# 작업 완료 검증 /sc:reflect --type completion --validate # 세션 분석 /sc:reflect --type session --analyze # 작업 회고 /sc:reflect --type task
# 스마트 커밋 /sc:git commit # 메시지 포함 커밋 /sc:git commit "로그인 기능 구현" # PR 생성 /sc:git pr # 브랜치 관리 /sc:git branch feature/auth
# API 문서 생성 /sc:document api/ # 컴포넌트 문서 /sc:document src/components/Button.tsx # README 생성 /sc:document --type readme
# 인덱스 생성 /sc:index-repo # 빠른 업데이트 /sc:index-repo mode=quick # 전체 재생성 /sc:index-repo mode=create
# 전체 인덱스 생성 /sc:index # API 문서 인덱스 /sc:index --type api # 구조 분석 /sc:index --type structure
# 체크포인트 저장 /sc:save "feature-auth-complete" # 전체 세션 저장 /sc:save --type all # 학습 내용 저장 /sc:save --type learnings
# 체크포인트 로드 /sc:load "feature-auth-complete" # 프로젝트 컨텍스트 로드 /sc:load --type project # 분석과 함께 로드 /sc:load --analyze
# 복잡한 작업 실행 /sc:task "로그인 시스템 전체 구현" # 병렬 처리 /sc:task "API 구현" --parallel # 위임 실행 /sc:task "문서화" --delegate
# 다중 작업 스폰 /sc:spawn "API 문서화" "테스트 작성" "코드 리뷰" # 병렬 실행 /sc:spawn "인증" "결제" --strategy parallel # 깊은 분해 /sc:spawn "전체 리팩토링" --depth deep
# 딥 리서치 에이전트 /sc:agent deep-research # 셀프 리뷰 에이전트 /sc:agent self-review # 저장소 인덱스 에이전트 /sc:agent repo-index
# 최적 도구 선택 /sc:select-tool "대규모 코드베이스 분석" # 분석 포함 /sc:select-tool "리팩토링" --analyze # 설명 포함 /sc:select-tool "테스트" --explain
# 전략 평가 /sc:business-panel "신규 SaaS 서비스 시장 진입 전략" --mode discussion # 경쟁 분석 (토론 모드) /sc:business-panel "경쟁사 대비 차별화 전략" --mode debate # 혁신 평가 (소크라테스 모드) /sc:business-panel "AI 기반 신기능 도입" --mode socratic
# 요구사항 검토 /sc:spec-panel @docs/prd.md --focus requirements # 아키텍처 검토 /sc:spec-panel "마이크로서비스 전환 계획" --focus architecture # 테스트 전략 검토 /sc:spec-panel @test-plan.md --focus testing
SuperClaude는 키워드 기반으로 전문 에이전트를 자동 활성화합니다. @agent-[name]으로 수동 지정도 가능합니다.
@agent-[name]으로 직접 지정 가능. 예: @agent-security-engineer
| 모드 | 용도 | 자동 활성화 | 수동 플래그 |
|---|---|---|---|
| Brainstorming | 아이디어 발굴, 요구사항 탐색 | 모호한 요청, "maybe", "could we" | --brainstorm |
| Introspection | 추론 과정 노출, 디버깅 | 에러 복구, 복잡한 문제 | --introspect |
| Deep Research | 체계적 정보 수집 | /sc:research, 리서치 키워드 | --research |
| Task Management | 복잡한 작업 조율 | 3단계 이상, 다중 파일 | --task-manage |
| Orchestration | 도구 최적화, 병렬 실행 | 다중 도구 작업 | --orchestrate |
| Token Efficiency | 토큰 30-50% 절감 | 컨텍스트 75% 이상 | --uc |
| Standard | 일반 개발 작업 | 기본값 | - |
| 플래그 | 설명 | 토큰 예산 |
|---|---|---|
--think | 구조화된 분석 | ~4K 토큰 |
--think-hard | 심층 분석 | ~10K 토큰 |
--ultrathink | 최대 깊이 분석 | ~32K 토큰 |
| 플래그 | MCP 서버 | 용도 |
|---|---|---|
--c7 | Context7 | 문서 검색 |
--seq | Sequential | 단계적 추론 |
--play | Playwright | 브라우저 자동화 |
--serena | Serena | 코드 분석 |
--magic | Magic | UI 컴포넌트 |
--morph | Morphllm | 벌크 코드 변환 |
| 플래그 | 설명 |
|---|---|
--loop | 반복 개선 사이클 |
--safe-mode | 최대 검증, 보수적 실행 |
--validate | 실행 전 위험 평가 |
--delegate | 서브 에이전트 병렬 처리 |
--preview | 실행 없이 미리보기 |
--dry-run | 시뮬레이션 모드 |
--interactive | 대화형 모드 |
SuperClaude는 8개의 MCP 서버와 통합됩니다. Nexol MCP Gateway를 통해 제공되며, 일부는 자체 호스팅(오픈소스), 일부는 외부 API를 사용합니다:
| 서버 | 용도 | 제공 방식 | 플래그 | 비고 |
|---|---|---|---|---|
| 🔍 SearXNG | 메타 웹 검색 | ✅ 자체 호스팅 | --searx |
오픈소스 - Tavily 대안 (70+ 검색엔진) |
| Serena | 코드 분석 | ✅ 자체 호스팅 | --serena |
오픈소스 - AST 기반 코드 이해 |
| Sequential-Thinking | 단계적 추론 | ✅ 오픈소스 MCP | --seq |
복잡한 문제 분해 |
| Playwright | 브라우저 자동화 | ✅ 오픈소스 MCP | --play |
E2E 테스트, 스크래핑 |
| Context7 | 문서 검색 | ⚡ 외부 API | --c7 |
Upstash API - 공식 문서 조회 |
| Magic | UI 컴포넌트 | ⚡ 외부 API | --magic |
21st.dev API - UI 생성 |
| Morphllm | 코드 수정 | ⚡ 외부 API | --morph |
Morph LLM API - 대규모 코드 변환 |
| Tavily | 웹 검색 | ⚡ 외부 API | - | 상용 API (SearXNG 권장) |
nexol-mcp 연결됨 → AIRIS Gateway가 60+ 도구 자동 제공--c7, --seq, --play 등 플래그 → 해당 도구 우선 활용9명의 경영 전문가가 다각도로 분석합니다:
# 전략 평가 /sc:business-panel "신규 SaaS 서비스 시장 진입 전략" --mode discussion # 경쟁 분석 /sc:business-panel "경쟁사 대비 차별화 전략" --mode debate # 혁신 평가 /sc:business-panel "AI 기반 신기능 도입" --mode socratic
10명의 소프트웨어 전문가가 스펙을 리뷰합니다:
# 요구사항 검토 /sc:spec-panel @docs/prd.md --focus requirements # 아키텍처 검토 /sc:spec-panel "마이크로서비스 전환 계획" --focus architecture # 테스트 전략 검토 /sc:spec-panel @test-plan.md --focus testing
# 기본 리서치 /sc:research "Next.js 14 App Router 베스트 프랙티스" # 깊이 옵션 지정 /sc:research "React 상태관리 비교" --depth deep # 전략 지정 (planning, intent, unified) /sc:research "Docker 보안" --depth exhaustive --strategy unified
6단계 워크플로우로 체계적 정보 수집. 결과는 docs/research/[topic]_[timestamp].md에 저장됩니다.
# 백엔드 기능 구현 /sc:implement "JWT 기반 인증 시스템" --type backend --focus security # 프론트엔드 + Magic UI /sc:implement "대시보드 컴포넌트" --type frontend --magic --c7 # 풀스택 + 문서 참조 /sc:implement "사용자 CRUD REST API" --type fullstack --c7
20개 전문 에이전트가 분야별로 협력하여 구현합니다.
/sc:brainstorm "쇼핑몰 MVP 기능 정의"
/sc:research "Next.js 14 + Prisma + PostgreSQL 스택"
/sc:design shopping-mall --type architecture
/sc:workflow "쇼핑몰 MVP 구현"
/sc:implement "상품 목록 페이지"
/sc:analyze --type architecture
/sc:analyze --type quality src/legacy/
/sc:design refactoring-plan --type architecture
/sc:improve src/legacy/ --type refactor
/sc:test --coverage
/sc:troubleshoot "결제 처리 중 오류 발생"
/sc:analyze src/payment/ --type security
/sc:implement "결제 오류 핸들링 개선"
/sc:test src/payment/
/sc:git commit "fix: 결제 오류 핸들링 개선"
/sc:pm
/sc:pm "이번 스프린트 작업 분배해줘"
/sc:pm "현재 진행 상황 정리해줘"
/sc:analyze --focus security
/sc:research "OWASP Top 10 최신 동향" --depth deep
/sc:implement "보안 취약점 패치" --type backend --focus security
/sc:test --coverage --focus security
/sc:git commit "fix: 보안 취약점 패치"
/sc:design payment-api --type api --format spec
/sc:implement "결제 API 엔드포인트" --type backend
/sc:test src/api/payment/
/sc:document src/api/payment/ --type api
/sc:index --type api