SuperClaude Framework 완벽 가이드: 30개 슬래시 커맨드로 Claude Code를 개발 플랫폼으로 변환하기

SuperClaude Framework는 Claude Code를 구조화된 개발 플랫폼으로 변환하는 메타 프로그래밍 설정 프레임워크입니다. 30개의 슬래시 커맨드, 16개의 전문 AI 에이전트, 7가지 행동 모드, 8개의 MCP 서버 통합을 제공하여 브레인스토밍부터 배포까지 전체 개발 라이프사이클을 체계적으로 자동화합니다. 이 글에서는 모든 커맨드의 사용법과 실전 활용 방법을 상세히 다룹니다.

SuperClaude Framework란?

SuperClaude는 Anthropic의 Claude Code CLI에 행동 지시(behavioral instruction injection)와 컴포넌트 오케스트레이션을 통해 구조화된 워크플로우를 부여하는 프레임워크입니다. 현재 버전 4.2.0으로, MIT 라이선스 하에 오픈소스로 공개되어 있습니다.

설치 방법

pipx를 이용한 설치가 권장됩니다:

# PyPI에서 설치
pipx install superclaude

# 30개 슬래시 커맨드 설치
superclaude install

# MCP 서버 설치 (선택, 성능 향상용)
superclaude mcp --list
superclaude mcp

# 설치 확인
superclaude doctor

Git에서 직접 설치하는 방법도 있습니다:

git clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git
cd SuperClaude_Framework
./install.sh

커맨드 카테고리 총정리

SuperClaude의 30개 커맨드는 8개 카테고리로 구분됩니다. 모든 커맨드는 /sc: 네임스페이스 접두사를 사용합니다.

오케스트레이션 커맨드 상세

/sc:pm - 프로젝트 매니저 에이전트

별도 호출 없이 항상 백그라운드에서 활성화되는 에이전트입니다. PDCA(Plan-Do-Check-Act) 사이클을 자동으로 실행하고, 과거 세션 컨텍스트를 복원하며, 작업을 적절한 페르소나(백엔드, 프론트엔드, 보안 등)에 위임합니다.

# 사용자가 "인증 시스템을 추가하고 싶어"라고 말하면 PM Agent가 자동으로:
# 1. 브레인스토밍 모드 활성화 (요구사항이 모호할 경우)
# 2. requirements-analyst에 위임
# 3. system-architect에 위임
# 4. security-engineer에 위임
# 5. backend-architect에 위임
# 6. quality-engineer에 위임

/sc:spawn - 대규모 작업 분해

복잡한 프로젝트를 Epic → Story → Task → Subtask로 체계적으로 분해합니다. 순차적, 병렬, 적응형 전략을 지원합니다.

# 모놀리스 마이그레이션
/sc:spawn "레거시 모놀리스를 마이크로서비스로 마이그레이션" --strategy adaptive --depth deep

# 의존성 있는 기능
/sc:spawn "사용자 인증 시스템 구현"
# 결과: DB 설계 → 백엔드 API → 프론트엔드 UI → 테스트

/sc:task - 작업 실행 관리

MCP 서버를 연동하여 구체적인 작업을 실행합니다. 필요한 페르소나를 자동 활성화하고 병렬 실행을 지원합니다.

# 엔터프라이즈급 기능
/sc:task create "엔터프라이즈 인증 시스템" --strategy systematic --parallel

# 애자일 스프린트
/sc:task execute "기능 백로그" --strategy agile --delegate

/sc:workflow - 구현 워크플로우 생성

PRD나 기능 명세서에서 단계별 구현 계획을 생성합니다. 코드를 직접 작성하지 않고 로드맵만 만들어줍니다.

# PRD 파일에서 워크플로우 생성
/sc:workflow docs/PRD/auth-feature.md --strategy systematic --depth deep

# 설명에서 직접 생성
/sc:workflow "사용자 인증 시스템" --strategy agile --parallel

발견 및 리서치 커맨드

/sc:brainstorm - 요구사항 발견

모호한 아이디어를 소크라테스식 질문을 통해 구체적인 요구사항 명세서로 변환합니다. 실현 가능성도 함께 점검합니다.

# 새 제품 구상
/sc:brainstorm "AI 기반 프로젝트 관리 도구" --strategy systematic --depth deep
# Claude: 어떤 문제를 해결해야 하나요? 대상 팀은? 필요한 연동은?

# 기능 탐색
/sc:brainstorm "실시간 협업 기능" --strategy agile --parallel

/sc:research - 딥 웹 리서치

Tavily MCP를 활용한 자율적 웹 연구 시스템입니다. 최대 5단계의 멀티홉 추론과 병렬 검색을 지원하며, 연구 결과를 claudedocs/research_*.md에 저장합니다.

/sc:research "양자 컴퓨팅 최신 동향" --depth deep
/sc:research "AI 코딩 도구 경쟁 분석" --depth exhaustive

구현 커맨드

/sc:implement - 코드 구현

무엇을 만들어야 하는지 명확할 때 사용합니다. 필요한 페르소나를 자동 활성화하고, Context7 MCP로 프레임워크별 패턴을 참조하며, Magic MCP로 UI 컴포넌트를 생성합니다.

# React 컴포넌트
/sc:implement 사용자 프로필 컴포넌트 --type component --framework react --with-tests

# 보안이 중요한 API
/sc:implement 사용자 인증 API --type api --safe --with-tests

# 풀스택 기능
/sc:implement 결제 처리 시스템 --type feature --with-tests

/sc:design - 시스템 설계

코드 작성 없이 아키텍처 다이어그램, API 스펙, 데이터베이스 스키마, 컴포넌트 인터페이스를 설계합니다.

/sc:design 사용자관리시스템 --type architecture --format diagram
/sc:design 결제-api --type api --format spec
/sc:design 이커머스-db --type database --format diagram

품질 관리 커맨드

/sc:analyze - 코드 분석

코드 감사가 필요할 때 사용합니다. 품질(코드 스멜, 유지보수성), 보안(취약점, OWASP), 성능(병목), 아키텍처(기술 부채) 분석을 제공합니다.

/sc:analyze src/auth --focus security --depth deep
/sc:analyze --focus performance --format report
/sc:analyze src/components --focus quality --depth quick

/sc:troubleshoot - 문제 진단

버그, 빌드 오류, 성능 저하 등의 근본 원인을 분석합니다. 기본적으로 진단만 수행하며, --fix 플래그를 추가해야 수정을 적용합니다.

/sc:troubleshoot "사용자 서비스에서 NullPointerException 발생" --type bug --trace --fix
/sc:troubleshoot "TypeScript 컴파일 오류" --type build --fix
/sc:troubleshoot "API 응답 시간 저하" --type performance

/sc:test - 테스트 실행

테스트 러너를 자동 감지하고, 커버리지 리포트를 생성하며, Playwright MCP로 E2E 테스트를 지원합니다.

/sc:test src/components --type unit --coverage
/sc:test --type e2e    # Playwright MCP 활성화
/sc:test --watch --fix

/sc:build - 프로젝트 빌드

컴파일, 번들링, 최적화를 처리하고 빌드 오류를 분석합니다.

/sc:build --type prod --clean --optimize
/sc:build frontend --verbose

코드 개선 커맨드

/sc:improve - 코드 개선

이미 작동하는 코드를 더 좋게 만들고 싶을 때 사용합니다. 안전한 변경은 자동 적용하고, 위험한 변경은 확인을 요청합니다.

/sc:improve src/ --type quality --safe
/sc:improve api-endpoints --type performance --interactive
/sc:improve auth-service --type security --validate

/sc:cleanup - 코드 정리

데드 코드, 사용하지 않는 import, 구조적 문제를 제거합니다. 안전한 수준의 정리는 자동으로, 참조된 코드는 확인 후 제거합니다.

/sc:cleanup src/ --type code --safe
/sc:cleanup --type imports --preview
/sc:cleanup --type all --interactive

문서화 커맨드

/sc:explain - 코드 설명

코드를 기초/중급/고급 수준으로 설명합니다. Context7 MCP를 통해 프레임워크별 설명도 제공합니다.

/sc:explain authentication.js --level basic
/sc:explain react-hooks --level intermediate --context react
/sc:explain microservices-system --level advanced --format interactive

/sc:document - 문서 생성

인라인 주석(JSDoc), API 문서, 사용자 가이드, 외부 문서를 자동 생성합니다.

/sc:document src/auth/login.js --type inline
/sc:document src/api --type api --style detailed
/sc:document payment-module --type guide --style brief

/sc:index-repo - 레포지토리 인덱싱

대규모 레포지토리 작업 시작 전에 사용합니다. 58KB 분량의 프로젝트 정보를 3KB의 PROJECT_INDEX.md로 압축하여 94%의 토큰을 절약합니다.

/sc:index-repo                # 전체 인덱싱
/sc:index-repo mode=update    # 기존 인덱스 업데이트
/sc:index-repo mode=quick     # 빠른 인덱싱 (테스트 제외)

전문가 패널 커맨드

/sc:spec-panel - 전문가 스펙 리뷰

10명의 저명한 소프트웨어 엔지니어링 전문가가 패널 토론 형식으로 스펙을 리뷰합니다.

3가지 운영 모드를 지원합니다:

• --mode discussion: 전문가들이 서로의 아이디어를 발전시키는 협업 모드
• --mode critique: 심각도와 우선순위를 매기는 체계적 리뷰 모드
• --mode socratic: 깊은 이해를 위한 질문 기반 학습 모드

# API 스펙 리뷰
/sc:spec-panel @auth_api.spec.yml --mode critique --focus requirements,architecture

# 소크라테스식 학습
/sc:spec-panel @my_first_spec.yml --mode socratic --iterations 2

/sc:business-panel - 비즈니스 분석 패널

9명의 전설적인 비즈니스 사상가가 전략, 계획, 아이디어를 분석합니다.

# 사업 계획 분석
/sc:business-panel @business_plan.md

# 전략 스트레스 테스트
/sc:business-panel @strategy.md --mode debate

# 경쟁 분석
/sc:business-panel @market_analysis.md --experts "porter,christensen" --focus "competitive-analysis"

유틸리티 커맨드

/sc:git - Git 연동

스마트 커밋 메시지 자동 생성과 대화형 Git 작업을 지원합니다.

/sc:git commit --smart-commit    # 컨벤셔널 커밋 메시지 자동 생성
/sc:git merge feature-branch --interactive

/sc:estimate - 개발 추정

작업의 시간, 노력, 복잡도를 추정합니다.

/sc:estimate "사용자 인증 시스템" --type time --unit days --breakdown
# DB 설계: 2일
# 백엔드 API: 3일
# 프론트엔드 UI: 2일
# 테스트: 1일
# 총계: 8일 (신뢰도 85%)

/sc:reflect - 진행 검증

작업 진행 상황을 점검하고 접근 방식을 검증합니다.

/sc:reflect --type task --analyze       # 현재 접근법 검증
/sc:reflect --type session --validate   # 세션 분석
/sc:reflect --type completion           # 완료 준비 상태 확인

/sc:load & /sc:save - 세션 관리

Serena MCP를 통해 세션 상태를 저장하고 복원합니다. 작업 중간에 중단했다가 다시 이어서 작업할 수 있습니다.

/sc:recommend - 커맨드 추천

현재 상황에 가장 적합한 SuperClaude 커맨드를 추천해주는 유틸리티입니다.

커맨드 선택 가이드

어떤 커맨드를 써야 할지 모를 때 참고하세요:

아이디어가 모호하다면?
    → /sc:brainstorm (요구사항 명확화)
        ↓
리서치가 필요하다면?
    → /sc:research (웹 조사)
        ↓
PRD가 준비되었다면?
    → /sc:workflow (구현 계획 생성)
        ↓
복잡한 분해가 필요하다면?
    → /sc:spawn (Epic → Story → Task)
        ↓
설계가 필요하다면?
    → /sc:design (아키텍처, API, 스키마)
        ↓
코드를 작성할 준비가 되었다면?
    → /sc:implement (코드 작성)
        ↓
테스트가 필요하다면?
    → /sc:test (테스트 실행)
        ↓
문제가 발생했다면?
    → /sc:troubleshoot (원인 파악)
        ↓
개선하고 싶다면?
    → /sc:improve 또는 /sc:cleanup
        ↓
문서화가 필요하다면?
    → /sc:document
        ↓
리뷰가 필요하다면?
    → /sc:analyze (코드) 또는 /sc:spec-panel (스펙)

MCP 서버 통합

SuperClaude는 8개의 MCP 서버를 통합하여 성능을 극대화합니다. MCP 없이도 완벽하게 작동하지만, MCP를 설치하면 2-3배 빠른 실행과 30-50% 토큰 절약 효과를 얻을 수 있습니다.

# MCP 서버 설치
superclaude mcp --list                               # 사용 가능한 서버 목록
superclaude mcp --servers tavily --servers context7   # 특정 서버 설치
superclaude mcp                                      # 대화형 설치

16개 전문 에이전트

SuperClaude에는 도메인 전문 지식을 갖춘 16개의 특화된 AI 에이전트가 있습니다. 컨텍스트에 따라 자동으로 조율되며, PM 에이전트가 작업을 적절한 전문 에이전트에 위임합니다.

• PM Agent - 전체 프로젝트 조율, PDCA 사이클, 세션 관리
• Deep Research Agent - 자율적 웹 리서치, 멀티홉 추론
• Security Engineer - 취약점 탐지, OWASP 분석
• Frontend Architect - UI 패턴, 컴포넌트 설계
• Backend Architect - API 설계, 데이터 모델링
• Quality Engineer - 테스트 전략, 커버리지 분석
• Requirements Analyst - 요구사항 분석, 명세서 작성
• System Architect - 시스템 설계, 기술 의사결정

7가지 행동 모드

상황에 따라 Claude의 행동 방식을 조정하는 7가지 모드입니다:

• Brainstorming - 올바른 질문을 던지는 탐색 모드
• Business Panel - 다중 전문가 전략 분석
• Deep Research - 자율적 웹 리서치
• Orchestration - 효율적 도구 조율
• Token-Efficiency - 30-50% 컨텍스트 절약
• Task Management - 체계적 작업 관리
• Introspection - 메타인지 분석

실전 워크플로우 예시

새 기능 개발 (처음부터 끝까지)

# 1단계: 요구사항 명확화
/sc:brainstorm "결제 시스템 추가" --depth deep

# 2단계: 기술 리서치
/sc:research "결제 게이트웨이 비교 2026" --depth standard

# 3단계: 설계
/sc:design payment-system --type architecture --format diagram

# 4단계: 구현 계획
/sc:workflow "결제 시스템 구현" --strategy systematic

# 5단계: 코드 구현
/sc:implement "Stripe 결제 연동" --type feature --with-tests --safe

# 6단계: 품질 검증
/sc:analyze src/payment --focus security --depth deep
/sc:test --type all --coverage

# 7단계: 문서화
/sc:document src/payment --type api --style detailed

레거시 코드 개선

# 1단계: 현재 상태 분석
/sc:analyze src/legacy --focus quality --depth deep

# 2단계: 문제 진단
/sc:troubleshoot "성능 저하 원인" --type performance

# 3단계: 개선 적용
/sc:improve src/legacy --type performance --interactive

# 4단계: 정리
/sc:cleanup src/legacy --type all --safe

마무리

SuperClaude Framework는 Claude Code의 잠재력을 극대화하는 강력한 도구입니다. 30개의 체계적인 슬래시 커맨드를 통해 개발 워크플로우의 모든 단계를 커버하며, MCP 서버 통합으로 성능까지 최적화합니다. 오픈소스이므로 누구나 무료로 사용할 수 있으며, PyPI 또는 GitHub에서 바로 설치하여 시작할 수 있습니다.

더 자세한 정보는 공식 GitHub 저장소와 공식 웹사이트에서 확인할 수 있습니다.