메인으로 돌아가기
NEW 버전 보기 OLD (현재)

SuperClaude Framework v4.3.0

Claude Code를 구조화된 개발 플랫폼으로 변환하는 메타 프로그래밍 프레임워크

원클릭 설치

터미널에서 아래 명령어를 실행하세요:

curl -fsSL https://mcp.nexol.co.kr/install-superclaude.sh | bash
NEW IN v4.3.0

v4.3.0 주요 변경사항

20개 AI 에이전트 (4개 신규 추가)
Agent 세션 컨트롤러 (/sc:agent)
PM Agent 자기 개선 워크플로우
Deep Research 적응형 전략
MCP 도구 지능형 선택 강화
리포지토리 인덱싱 94% 토큰 절감
📦
30
슬래시 커맨드
🤖
20
AI 에이전트
🎯
7
운영 모드
🔌
8
MCP 서버

📑 목차

설치 방법

1

pipx로 설치

Python 3.10 이상 필요

pipx install superclaude
2

Claude Code에 명령어 설치

superclaude install
3

설치 확인

superclaude doctor
💡 팁: 업그레이드하려면 pipx upgrade superclaude && superclaude install --force 실행

전체 슬래시 명령어 (30개)

🎯 핵심 명령어 (4)

/sc:sc Core
SuperClaude 명령어 디스패처 - 전체 명령어 목록 및 도움말
/sc:sc
/sc:pm Core
프로젝트 매니저 에이전트 - 모든 서브 에이전트를 조율하고 워크플로우 관리 (자동 활성화)
/sc:pm [요청] [--strategy brainstorm|direct|wave] [--verbose]
예시 보기
# PM 모드 시작 (보통 자동 활성화)
/sc:pm

# 브레인스토밍 전략으로 시작
/sc:pm "인증 시스템 설계해줘" --strategy brainstorm

# 웨이브 전략으로 대규모 작업
/sc:pm "보안 감사 전체 실행" --strategy wave
/sc:recommend Core
사용자 요청에 가장 적합한 SuperClaude 명령어 추천 엔진
/sc:recommend [요청] [--estimate] [--alternatives]
예시 보기
# 명령어 추천 받기
/sc:recommend "로그인 기능 구현하고 싶어"

# 시간 예측 포함
/sc:recommend "API 문서화" --estimate

# 대안 제시
/sc:recommend "성능 최적화" --alternatives
/sc:help Core
사용 가능한 모든 /sc 명령어와 기능 목록 표시
/sc:help

🔍 리서치 & 분석 (4)

/sc:research Workflow
적응형 계획과 지능형 검색을 활용한 딥 웹 리서치
/sc:research "[쿼리]" [--depth quick|standard|deep|exhaustive] [--strategy planning|intent|unified]
예시 보기
# 기본 리서치
/sc:research "Next.js 14 App Router 베스트 프랙티스"

# 깊이 있는 리서치
/sc:research "React 상태관리 비교" --depth deep

# 철저한 리서치
/sc:research "Docker 보안" --depth exhaustive --strategy unified
/sc:analyze Utility
품질, 보안, 성능, 아키텍처 영역에 걸친 종합 코드 분석
/sc:analyze [대상] [--focus quality|security|performance|architecture] [--depth quick|deep]
예시 보기
# 품질 분석
/sc:analyze --focus quality

# 보안 심층 분석
/sc:analyze src/ --focus security --think-hard

# 아키텍처 분석 (최대 깊이)
/sc:analyze . --focus architecture --ultrathink
/sc:explain Workflow
코드, 개념, 시스템 동작을 교육적으로 명확하게 설명
/sc:explain [대상] [--level basic|intermediate|advanced] [--format text|examples|interactive]
예시 보기
# 파일 설명
/sc:explain src/utils/auth.ts

# 알고리즘 설명
/sc:explain "이 정렬 알고리즘이 어떻게 동작하는지"

# 프로젝트 구조 설명
/sc:explain "이 프로젝트의 전체 구조"
/sc:troubleshoot Utility
코드, 빌드, 배포, 시스템 동작의 문제 진단 및 해결
/sc:troubleshoot [이슈] [--type bug|build|performance|deployment] [--trace] [--fix]
예시 보기
# 빌드 오류 진단
/sc:troubleshoot "npm run build 실패" --type build --trace

# 버그 수정
/sc:troubleshoot "TypeError: Cannot read property" --type bug --fix

# 성능 문제
/sc:troubleshoot "API 응답이 느림" --type performance --seq

📐 설계 & 계획 (4)

/sc:design Utility
시스템 아키텍처, API, 컴포넌트 인터페이스 설계
/sc:design [대상] [--type architecture|api|component|database] [--format diagram|spec|code]
예시 보기
# 아키텍처 설계
/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 Workflow
소크라테스식 대화와 체계적 탐색을 통한 요구사항 발굴
/sc:brainstorm [주제] [--strategy systematic|agile|enterprise] [--depth shallow|normal|deep]
예시 보기
# 기능 아이디어 도출
/sc:brainstorm "사용자 참여를 높일 수 있는 기능"

# 기술 솔루션 탐색
/sc:brainstorm "대용량 파일 업로드 처리 방법"

# 문제 해결 아이디어
/sc:brainstorm "API 응답 속도 개선 방안"
/sc:workflow Workflow
PRD 및 기능 요구사항에서 구조화된 구현 워크플로우 생성
/sc:workflow [PRD파일|기능설명] [--strategy systematic|agile|enterprise] [--parallel]
예시 보기
# PRD에서 워크플로우 생성
/sc:workflow docs/prd.md

# 기능에서 작업 분해
/sc:workflow "사용자 인증 시스템 구현"
/sc:estimate Special
작업, 기능, 프로젝트의 개발 예상 시간 분석
/sc:estimate [대상] [--type time|effort|complexity] [--unit hours|days|weeks] [--breakdown]
예시 보기
# 기능 시간 예측
/sc:estimate "사용자 대시보드 구현"

# 전체 프로젝트 예측
/sc:estimate --scope project

# 상세 분해
/sc:estimate "인증 시스템" --breakdown

💻 개발 & 구현 (4)

/sc:implement Workflow
지능형 페르소나 활성화와 MCP 통합을 활용한 기능/코드 구현
/sc:implement [기능설명] [--type component|api|service|feature] [--framework react|vue|express] [--safe] [--with-tests]
예시 보기
# 백엔드 구현
/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 Workflow
코드 품질, 성능, 유지보수성에 대한 체계적 개선
/sc:improve [대상] [--type quality|performance|maintainability|style] [--safe] [--interactive]
예시 보기
# 안전한 리팩토링 (미리보기)
/sc:improve src/services/ --type quality --safe --preview

# 성능 최적화 (반복 개선)
/sc:improve api/handlers/ --type performance --loop

# 보안 강화
/sc:improve auth/ --type security --validate
/sc:build Utility
지능형 오류 처리와 최적화를 통한 빌드, 컴파일, 패키징
/sc:build [대상] [--type dev|prod|test] [--clean] [--optimize] [--verbose]
예시 보기
# 기본 빌드
/sc:build

# 프로덕션 빌드
/sc:build --production

# 오류 자동 수정
/sc:build --fix-errors
/sc:cleanup Workflow
데드코드 제거, 프로젝트 구조 최적화, 코드 정리
/sc:cleanup [대상] [--type code|imports|files|all] [--safe|--aggressive] [--interactive]
예시 보기
# 안전한 코드 정리
/sc:cleanup src/ --type all --safe

# 인터랙티브 정리
/sc:cleanup --type code --interactive

# 적극적 정리
/sc:cleanup --type all --aggressive

🧪 테스트 & QA (2)

/sc:test Utility
테스트 실행 + 커버리지 분석 + 자동 품질 리포팅
/sc:test [대상] [--type unit|integration|e2e|all] [--coverage] [--watch] [--fix]
예시 보기
# 전체 테스트 + 커버리지
/sc:test --coverage

# 유닛 테스트만
/sc:test --type unit

# E2E 테스트 (Playwright)
/sc:test --type e2e --play

# 워치 모드
/sc:test --watch --fix
/sc:reflect Special
Serena MCP 분석 기능을 활용한 작업 검증 및 반영
/sc:reflect [--type task|session|completion] [--analyze] [--validate]
예시 보기
# 작업 완료 검증
/sc:reflect --type completion --validate

# 세션 분석
/sc:reflect --type session --analyze

# 작업 회고
/sc:reflect --type task

🔧 Git & 문서화 (4)

/sc:git Utility
지능형 커밋 메시지와 워크플로우 최적화를 통한 Git 커밋/리베이스/히스토리 관리
/sc:git [작업] [인자] [--smart-commit] [--interactive]
예시 보기
# 스마트 커밋
/sc:git commit

# 메시지 포함 커밋
/sc:git commit "로그인 기능 구현"

# PR 생성
/sc:git pr

# 브랜치 관리
/sc:git branch feature/auth
/sc:document Utility
컴포넌트, 함수, API, 기능에 대한 문서 생성
/sc:document [대상] [--type inline|external|api|guide] [--style brief|detailed]
예시 보기
# API 문서 생성
/sc:document api/

# 컴포넌트 문서
/sc:document src/components/Button.tsx

# README 생성
/sc:document --type readme
/sc:index-repo Special
리포지토리 인덱싱 - 94% 토큰 절감 (58K → 3K)
/sc:index-repo [mode=create|update|quick]
예시 보기
# 인덱스 생성
/sc:index-repo

# 빠른 업데이트
/sc:index-repo mode=quick

# 전체 재생성
/sc:index-repo mode=create
/sc:index Special
종합 프로젝트 문서 및 지식 베이스 생성
/sc:index [대상] [--type docs|api|structure|readme] [--format md|json|yaml]
예시 보기
# 전체 인덱스 생성
/sc:index

# API 문서 인덱스
/sc:index --type api

# 구조 분석
/sc:index --type structure

💾 세션 & 작업 관리 (6)

/sc:save Special
Serena MCP 통합을 통한 세션 컨텍스트 저장
/sc:save [--type session|learnings|context|all] [--summarize] [--checkpoint]
예시 보기
# 체크포인트 저장
/sc:save "feature-auth-complete"

# 전체 세션 저장
/sc:save --type all

# 학습 내용 저장
/sc:save --type learnings
/sc:load Special
Serena MCP 통합을 통한 프로젝트 컨텍스트 로드
/sc:load [대상] [--type project|config|deps|checkpoint] [--refresh] [--analyze]
예시 보기
# 체크포인트 로드
/sc:load "feature-auth-complete"

# 프로젝트 컨텍스트 로드
/sc:load --type project

# 분석과 함께 로드
/sc:load --analyze
/sc:task Special
지능형 워크플로우 관리와 위임을 통한 복잡 작업 실행
/sc:task [작업] [대상] [--strategy systematic|agile|enterprise] [--parallel] [--delegate]
예시 보기
# 복잡한 작업 실행
/sc:task "로그인 시스템 전체 구현"

# 병렬 처리
/sc:task "API 구현" --parallel

# 위임 실행
/sc:task "문서화" --delegate
/sc:spawn Special
지능형 분해와 위임을 통한 메타 시스템 작업 오케스트레이션
/sc:spawn [복잡작업] [--strategy sequential|parallel|adaptive] [--depth normal|deep]
예시 보기
# 다중 작업 스폰
/sc:spawn "API 문서화" "테스트 작성" "코드 리뷰"

# 병렬 실행
/sc:spawn "인증" "결제" --strategy parallel

# 깊은 분해
/sc:spawn "전체 리팩토링" --depth deep
/sc:agent Special
조사, 구현, 리뷰를 오케스트레이션하는 세션 컨트롤러
/sc:agent [type]
예시 보기
# 딥 리서치 에이전트
/sc:agent deep-research

# 셀프 리뷰 에이전트
/sc:agent self-review

# 저장소 인덱스 에이전트
/sc:agent repo-index
/sc:select-tool Special
복잡도 점수와 작업 분석 기반 지능형 MCP 도구 선택
/sc:select-tool [작업] [--analyze] [--explain]
예시 보기
# 최적 도구 선택
/sc:select-tool "대규모 코드베이스 분석"

# 분석 포함
/sc:select-tool "리팩토링" --analyze

# 설명 포함
/sc:select-tool "테스트" --explain

👥 전문가 패널 (2)

/sc:business-panel Special
9명 경영 전문가 패널 (Porter, Drucker, Christensen 등)
/sc:business-panel [문서|내용] [--experts "name1,name2"] [--mode discussion|debate|socratic]
예시 보기
# 전략 평가
/sc:business-panel "신규 SaaS 서비스 시장 진입 전략" --mode discussion

# 경쟁 분석 (토론 모드)
/sc:business-panel "경쟁사 대비 차별화 전략" --mode debate

# 혁신 평가 (소크라테스 모드)
/sc:business-panel "AI 기반 신기능 도입" --mode socratic
/sc:spec-panel Special
10명 SW 전문가 사양 검토 패널 (Fowler, Newman, Wiegers 등)
/sc:spec-panel [사양|@파일] [--mode discussion|critique|socratic] [--focus requirements|architecture|testing]
예시 보기
# 요구사항 검토
/sc:spec-panel @docs/prd.md --focus requirements

# 아키텍처 검토
/sc:spec-panel "마이크로서비스 전환 계획" --focus architecture

# 테스트 전략 검토
/sc:spec-panel @test-plan.md --focus testing

20개 전문 AI 에이전트

SuperClaude는 키워드 기반으로 전문 에이전트를 자동 활성화합니다. @agent-[name]으로 수동 지정도 가능합니다.

🏗️ 아키텍처 & 설계 (4)

🏢
system-architect
확장 가능한 시스템 아키텍처 설계
Architecture
⚙️
backend-architect
데이터 무결성, 보안, 장애 허용 중심 백엔드 설계
Architecture
🎨
frontend-architect
접근성, UX, 모던 프레임워크 기반 UI 구축
Architecture
🚀
devops-architect
인프라 자동화, CI/CD, 관찰가능성
Architecture

🔍 품질 & 보안 (4)

quality-engineer
테스트 전략, 엣지케이스 탐지
Quality
🔒
security-engineer
취약점 탐지, 보안 표준 준수
Security
performance-engineer
성능 최적화, 병목 제거
Performance
🔍
root-cause-analyst
증거 기반 근본 원인 분석
Analysis

💻 개발 & 코딩 (4)

🐍
python-expert
SOLID 원칙 기반 Python 전문가
Development
🔧
refactoring-expert
기술 부채 감소, 클린코드
Development
📊
repo-index
리포지토리 인덱싱 및 브리핑
Indexing
🪞
self-review
구현 후 검증 및 반성
Verification

🔬 리서치 & 전략 (4)

🔬
deep-research-agent
적응형 리서치 전략
Research
🌐
deep-research
외부 지식 수집 전문
Research
📋
requirements-analyst
요구사항 분석 및 구조화
Analysis
📈
pm-agent
PDCA 사이클 기반 지속적 개선 워크플로우
Strategy

📚 커뮤니케이션 & 학습 (4)

📝
technical-writer
대상별 맞춤 기술 문서
Communication
🎓
learning-guide
점진적 학습 및 실습 기반 프로그래밍 교육
Education
🤔
socratic-mentor
소크라테스 질문법 기반 교육
Education
👥
business-panel-experts
9인 경영 전문가 패널
Panel
수동 활성화: @agent-[name]으로 직접 지정 가능. 예: @agent-security-engineer

7가지 운영 모드

모드 용도 자동 활성화 수동 플래그
🧠 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 서버 플래그

플래그MCP 서버용도
--c7Context7문서 검색
--seqSequential단계적 추론
--playPlaywright브라우저 자동화
--serenaSerena코드 분석
--magicMagicUI 컴포넌트
--morphMorphllm벌크 코드 변환

🎮 실행 제어 플래그

플래그설명
--loop반복 개선 사이클
--safe-mode최대 검증, 보수적 실행
--validate실행 전 위험 평가
--delegate서브 에이전트 병렬 처리
--preview실행 없이 미리보기
--dry-run시뮬레이션 모드
--interactive대화형 모드

MCP 서버 통합

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 권장)
✅ 자체 호스팅 (4개) SearXNG, Serena, Sequential-Thinking, Playwright
Nexol 인프라에서 직접 운영. 외부 의존성 없음, 프라이버시 보호.
⚡ 외부 API (4개) Context7, Magic, Morphllm, Tavily
Nexol MCP Gateway를 통해 연결. API 키는 Nexol에서 관리.
🌱 오픈소스 우선 정책: Nexol은 가능한 경우 오픈소스 대안을 자체 호스팅합니다.
예: SearXNG는 Tavily의 오픈소스 대안으로, 70+ 검색엔진을 통합하며 비용 없이 무제한 사용 가능합니다.
🔌 MCP 연결만 하면 끝!

Nexol MCP Gateway에 연결되어 있으면 별도의 MCP 서버 설정이 필요 없습니다.

작동 방식:
  1. nexol-mcp 연결됨 → AIRIS Gateway가 60+ 도구 자동 제공
  2. Claude Code가 필요할 때 자동으로 해당 도구 호출
  3. SuperClaude 명령어의 --c7, --seq, --play 등 플래그 → 해당 도구 우선 활용

전문가 패널

🏢 비즈니스 패널 (/sc:business-panel)

9명의 경영 전문가가 다각도로 분석합니다:

Clayton Christensen 파괴적 혁신
Michael Porter 경쟁 전략
Peter Drucker 경영 관리
Seth Godin 마케팅
Kim/Mauborgne 블루오션 전략
Jim Collins Good to Great
Nassim Taleb 리스크 관리
Donella Meadows 시스템 사고
Jean-Luc Doumont 커뮤니케이션
# 전략 평가
/sc:business-panel "신규 SaaS 서비스 시장 진입 전략" --mode discussion

# 경쟁 분석
/sc:business-panel "경쟁사 대비 차별화 전략" --mode debate

# 혁신 평가
/sc:business-panel "AI 기반 신기능 도입" --mode socratic

📋 스펙 패널 (/sc:spec-panel)

10명의 소프트웨어 전문가가 스펙을 리뷰합니다:

Karl Wiegers 요구사항
Gojko Adzic 스펙 by 예제
Alistair Cockburn 유스케이스
Martin Fowler 아키텍처 패턴
Michael Nygard 릴리즈 전략
Sam Newman 마이크로서비스
Gregor Hohpe 엔터프라이즈 통합
Lisa Crispin 애자일 테스팅
Janet Gregory 품질 보증
Kelsey Hightower 클라우드 네이티브
# 요구사항 검토
/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개 전문 에이전트가 분야별로 협력하여 구현합니다.

실전 시나리오

🚀 시나리오 1: 새 프로젝트 시작

1
/sc:brainstorm "쇼핑몰 MVP 기능 정의"
소크라테스식 대화로 요구사항 발굴
2
/sc:research "Next.js 14 + Prisma + PostgreSQL 스택"
기술 스택 리서치 및 비교
3
/sc:design shopping-mall --type architecture
시스템 아키텍처 설계
4
/sc:workflow "쇼핑몰 MVP 구현"
구현 워크플로우 생성
5
/sc:implement "상품 목록 페이지"
기능 구현 시작

🔧 시나리오 2: 레거시 코드 리팩토링

1
/sc:analyze --type architecture
현재 아키텍처 상태 분석
2
/sc:analyze --type quality src/legacy/
코드 품질 문제점 파악
3
/sc:design refactoring-plan --type architecture
리팩토링 계획 수립
4
/sc:improve src/legacy/ --type refactor
단계별 코드 개선
5
/sc:test --coverage
테스트 커버리지 확인

🐛 시나리오 3: 버그 수정 플로우

1
/sc:troubleshoot "결제 처리 중 오류 발생"
문제 진단 및 근본 원인 분석
2
/sc:analyze src/payment/ --type security
관련 코드 보안 분석
3
/sc:implement "결제 오류 핸들링 개선"
수정 구현
4
/sc:test src/payment/
테스트 작성 및 실행
5
/sc:git commit "fix: 결제 오류 핸들링 개선"
스마트 커밋

📊 시나리오 4: PM 에이전트 활용

1
/sc:pm
PM 에이전트 시작 (보통 자동 활성화)
2
/sc:pm "이번 스프린트 작업 분배해줘"
작업 분배 및 우선순위 결정
3
/sc:pm "현재 진행 상황 정리해줘"
PDCA 사이클 기반 진행 상황 체크

🔒 시나리오 5: 보안 감사 플로우

1
/sc:analyze --focus security
전체 코드베이스 보안 분석
2
/sc:research "OWASP Top 10 최신 동향" --depth deep
최신 보안 동향 리서치
3
/sc:implement "보안 취약점 패치" --type backend --focus security
취약점 패치 구현
4
/sc:test --coverage --focus security
보안 테스트 및 커버리지 확인
5
/sc:git commit "fix: 보안 취약점 패치"
보안 패치 커밋

📡 시나리오 6: API 설계 & 문서화

1
/sc:design payment-api --type api --format spec
결제 API 스펙 설계
2
/sc:implement "결제 API 엔드포인트" --type backend
API 엔드포인트 구현
3
/sc:test src/api/payment/
API 테스트 작성 및 실행
4
/sc:document src/api/payment/ --type api
API 문서 자동 생성
5
/sc:index --type api
API 문서 인덱스 생성

링크