메인으로 돌아가기
NEW OLD 버전 보기

SuperClaude Framework v4.3.0

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

원클릭 설치

터미널에서 아래 명령어를 실행하세요. nexol-mcp 연결 시 자동 등록됩니다.

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개)

Start Here — 자주 쓰는 핵심 5개
/sc:sc
전체 명령어 목록 · 도움말 디스패처
/sc:pm
PM 에이전트 — 서브 에이전트 조율 · 워크플로우
/sc:research
딥 웹 리서치 · 적응형 검색 전략
/sc:implement
기능 · 코드 구현 · MCP 통합
/sc:analyze
품질 · 보안 · 성능 · 아키텍처 분석
핵심 명령어 4개
/sc:scCore
SuperClaude 명령어 디스패처 - 전체 명령어 목록 및 도움말
/sc:sc
/sc:pmCore
프로젝트 매니저 에이전트 - 모든 서브 에이전트를 조율하고 워크플로우 관리 (자동 활성화)
/sc:pm [요청] [--strategy brainstorm|direct|wave] [--verbose]
예시 보기
/sc:pm
/sc:pm "인증 시스템 설계해줘" --strategy brainstorm
/sc:pm "보안 감사 전체 실행" --strategy wave
/sc:recommendCore
사용자 요청에 가장 적합한 SuperClaude 명령어 추천 엔진
/sc:recommend [요청] [--estimate] [--alternatives]
예시 보기
/sc:recommend "로그인 기능 구현하고 싶어"
/sc:recommend "API 문서화" --estimate
/sc:recommend "성능 최적화" --alternatives
/sc:helpCore
사용 가능한 모든 /sc 명령어와 기능 목록 표시
/sc:help
리서치 & 분석 4개
/sc:researchMCP
적응형 계획과 지능형 검색을 활용한 딥 웹 리서치
/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:analyzeCore
품질, 보안, 성능, 아키텍처 영역에 걸친 종합 코드 분석
/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
코드, 개념, 시스템 동작을 교육적으로 명확하게 설명
/sc:explain [대상] [--level basic|intermediate|advanced] [--format text|examples|interactive]
예시 보기
/sc:explain src/utils/auth.ts
/sc:explain "이 정렬 알고리즘이 어떻게 동작하는지"
/sc:explain "이 프로젝트의 전체 구조"
/sc:troubleshoot
코드, 빌드, 배포, 시스템 동작의 문제 진단 및 해결
/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
시스템 아키텍처, API, 컴포넌트 인터페이스 설계
/sc:design [대상] [--type architecture|api|component|database] [--format diagram|spec|code]
예시 보기
/sc:design user-management --type architecture
/sc:design payment-api --type api --format spec
/sc:design e-commerce --type database --format diagram
/sc:brainstorm
소크라테스식 대화와 체계적 탐색을 통한 요구사항 발굴
/sc:brainstorm [주제] [--strategy systematic|agile|enterprise] [--depth shallow|normal|deep]
예시 보기
/sc:brainstorm "사용자 참여를 높일 수 있는 기능"
/sc:brainstorm "대용량 파일 업로드 처리 방법"
/sc:brainstorm "API 응답 속도 개선 방안"
/sc:workflow
PRD 및 기능 요구사항에서 구조화된 구현 워크플로우 생성
/sc:workflow [PRD파일|기능설명] [--strategy systematic|agile|enterprise] [--parallel]
예시 보기
/sc:workflow docs/prd.md
/sc:workflow "사용자 인증 시스템 구현"
/sc:estimate
작업, 기능, 프로젝트의 개발 예상 시간 분석
/sc:estimate [대상] [--type time|effort|complexity] [--unit hours|days|weeks] [--breakdown]
예시 보기
/sc:estimate "사용자 대시보드 구현"
/sc:estimate --scope project
/sc:estimate "인증 시스템" --breakdown
개발 & 구현 4개
/sc:implementMCP
지능형 페르소나 활성화와 MCP 통합을 활용한 기능/코드 구현
/sc:implement [기능설명] [--type component|api|service|feature] [--framework react|vue|express] [--safe] [--with-tests]
예시 보기
/sc:implement "JWT 기반 인증 시스템" --type backend --focus security
/sc:implement "대시보드 컴포넌트" --type frontend --magic --c7
/sc:implement "사용자 CRUD REST API" --type fullstack --c7
/sc:improve
코드 품질, 성능, 유지보수성에 대한 체계적 개선
/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
지능형 오류 처리와 최적화를 통한 빌드, 컴파일, 패키징
/sc:build [대상] [--type dev|prod|test] [--clean] [--optimize] [--verbose]
예시 보기
/sc:build
/sc:build --production
/sc:build --fix-errors
/sc:cleanup
데드코드 제거, 프로젝트 구조 최적화, 코드 정리
/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:testMCP
테스트 실행 + 커버리지 분석 + 자동 품질 리포팅
/sc:test [대상] [--type unit|integration|e2e|all] [--coverage] [--watch] [--fix]
예시 보기
/sc:test --coverage
/sc:test --type unit
/sc:test --type e2e --play
/sc:test --watch --fix
/sc:reflectMCP
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
지능형 커밋 메시지와 워크플로우 최적화를 통한 Git 커밋/리베이스/히스토리 관리
/sc:git [작업] [인자] [--smart-commit] [--interactive]
예시 보기
/sc:git commit
/sc:git commit "로그인 기능 구현"
/sc:git pr
/sc:git branch feature/auth
/sc:document
컴포넌트, 함수, API, 기능에 대한 문서 생성
/sc:document [대상] [--type inline|external|api|guide] [--style brief|detailed]
예시 보기
/sc:document api/
/sc:document src/components/Button.tsx
/sc:document --type readme
/sc:index-repo
리포지토리 인덱싱 — 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
종합 프로젝트 문서 및 지식 베이스 생성
/sc:index [대상] [--type docs|api|structure|readme] [--format md|json|yaml]
예시 보기
/sc:index
/sc:index --type api
/sc:index --type structure
세션 & 작업 관리 6개
/sc:saveMCP
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:loadMCP
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
지능형 워크플로우 관리와 위임을 통한 복잡 작업 실행
/sc:task [작업] [대상] [--strategy systematic|agile|enterprise] [--parallel] [--delegate]
예시 보기
/sc:task "로그인 시스템 전체 구현"
/sc:task "API 구현" --parallel
/sc:task "문서화" --delegate
/sc:spawn
지능형 분해와 위임을 통한 메타 시스템 작업 오케스트레이션
/sc:spawn [복잡작업] [--strategy sequential|parallel|adaptive] [--depth normal|deep]
예시 보기
/sc:spawn "API 문서화" "테스트 작성" "코드 리뷰"
/sc:spawn "인증" "결제" --strategy parallel
/sc:spawn "전체 리팩토링" --depth deep
/sc:agent
조사, 구현, 리뷰를 오케스트레이션하는 세션 컨트롤러
/sc:agent [type]
예시 보기
/sc:agent deep-research
/sc:agent self-review
/sc:agent repo-index
/sc:select-toolMCP
복잡도 점수와 작업 분석 기반 지능형 MCP 도구 선택
/sc:select-tool [작업] [--analyze] [--explain]
예시 보기
/sc:select-tool "대규모 코드베이스 분석"
/sc:select-tool "리팩토링" --analyze
/sc:select-tool "테스트" --explain
전문가 패널 2개
/sc:business-panel
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
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 에이전트

에이전트는 키워드 기반으로 자동 활성화됩니다. @agent-[name]으로 수동 지정도 가능합니다. 예: @agent-security-engineer. 각 에이전트는 특화된 지식과 추론 방식을 사용합니다.

아키텍처 & 설계 (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 NEW

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

📝
technical-writer
대상별 맞춤 기술 문서
Communication
🎓
learning-guide
점진적 학습 및 실습 기반 프로그래밍 교육
Education
🤔
socratic-mentor
소크라테스 질문법 기반 교육
Education
👥
business-panel-experts
9인 경영 전문가 패널
Panel

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벌크 코드 변환
--searxSearXNG메타 웹 검색

실행 제어 플래그

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

MCP 서버 통합 (8개)

SuperClaude는 8개의 MCP 서버와 통합됩니다. Nexol MCP Gateway를 통해 제공되며, 자체 호스팅(오픈소스)외부 API 방식이 혼합됩니다.

서버용도호스팅플래그비고
SearXNG메타 웹 검색자체 호스팅--searx오픈소스 Tavily 대안 (70+ 검색엔진)
Serena코드 분석자체 호스팅--serenaAST 기반 코드 이해
Sequential-Thinking단계적 추론오픈소스 MCP--seq복잡한 문제 분해
Playwright브라우저 자동화오픈소스 MCP--playE2E 테스트, 스크래핑
Context7문서 검색외부 API--c7Upstash API
MagicUI 컴포넌트외부 API--magic21st.dev API
Morphllm코드 수정외부 API--morphMorph LLM API
Tavily웹 검색외부 API-상용 API (SearXNG 권장)

Nexol MCP 연결만 하면 끝!

nexol-mcp 게이트웨이 연결 시 위 8개 포함 60+ MCP 도구가 자동으로 제공됩니다. 별도의 MCP 서버 설치 및 설정이 필요 없습니다.

  1. nexol-mcp 연결됨 → AIRIS Gateway가 60+ 도구 자동 제공
  2. Claude Code가 필요할 때 자동으로 해당 도구 호출
  3. SuperClaude 명령어의 --c7, --seq, --play 등 플래그 → 해당 도구 우선 활용
연결 확인:
claude mcp list | grep nexol
오픈소스 우선 정책: Nexol은 가능한 경우 오픈소스 대안을 자체 호스팅합니다. SearXNG는 Tavily의 오픈소스 대안으로, 70+ 검색엔진을 통합하며 비용 없이 무제한 사용 가능합니다.

전문가 패널

비즈니스 패널 (/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
/sc:research "Docker 보안" --depth exhaustive --strategy unified

6단계 워크플로우로 체계적 정보 수집. 결과는 docs/research/[topic]_[timestamp].md에 저장됩니다.

개발 & 구현

코드 구현

/sc:implement "JWT 기반 인증 시스템" --type backend --focus security
/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 문서 인덱스 생성

링크