SuperClaude Framework 완벽 가이드
🚀 개요
SuperClaude는 Claude Code를 위한 설정 프레임워크로, /sc: 접두사 커맨드를 통해 개발 효율성을 극대화하는 도구입니다.
주요 특징
- 16개 커스텀 커맨드:
/sc:접두사로 개발 라이프사이클 전 영역 커버 - 11개 페르소나: 역할별 맞춤 작업, 컨텍스트에 따른 자동 선택
- 자동 MCP 트리거: 상황에 맞는 자동 실행
- 무료 오픈소스: 간단한 설치, 별도 코드 없이 설정만으로 동작
📦 설치 방법
1. 사전 요구사항
UV 또는 Python이 설치되어 있어야 합니다.
# Windows (PowerShell 관리자 권한)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
# macOS
curl -LsSf https://astral.sh/uv/install.sh | sh
# 또는
brew install uv
# Python이 있다면
pip install uv
2. SuperClaude 설치
# 방법 1: PyPI에서 설치 (권장)
pip install SuperClaude
# 방법 2: Git Clone
git clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git
cd SuperClaude_Framework
uv sync
3. 설치 실행
SuperClaude install
설치 시 Quick Installation 선택을 권장합니다.
4. 설치 확인
# 명령어 파일 확인
ls ~/.claude/commands/
# Claude Code에서 "sc" 입력하여 자동완성 확인
🎯 핵심 커맨드
/sc:design - 프로젝트 설계
프로젝트 초기 설계와 아키텍처 계획을 수립합니다.
# 기본 설계 (플랜 포함)
/sc:design --plan
# 타입별 설계
/sc:design [대상] --type architecture # 시스템 아키텍처
/sc:design [대상] --type api # API 설계
/sc:design [대상] --type component # UI 컴포넌트
/sc:design [대상] --type database # 데이터베이스
/sc:design [대상] --type ui # 사용자 인터페이스
# 출력 형식 지정
/sc:design [대상] --format diagram # 다이어그램
/sc:design [대상] --format spec # 스펙 문서
/sc:design [대상] --format code # 실제 코드
실사용 예시:
# React 대시보드 설계
/sc:design react-dashboard --type ui --format diagram --plan
# 모바일 앱 아키텍처 설계
/sc:design mobile-app --type architecture --format diagram --scalable
/sc:implement - 코드 구현
설계된 내용을 실제 코드로 구현합니다.
# React 컴포넌트 구현
/sc:implement --react --magic
# 다양한 구현 옵션
/sc:implement --react --component # React 컴포넌트
/sc:implement --ultracompressed --magic # 토큰 절약 모드
/sc:build - 빌드 및 배포
프로젝트 빌드와 배포 관련 작업을 수행합니다.
# 데이터베이스 및 API 빌드
/sc:build --database --api
# 프론트엔드 빌드
/sc:build --frontend --production
/sc:analyze - 코드 분석
프로젝트의 구조, 성능, 보안을 분석합니다.
# 아키텍처 분석
/sc:analyze --architecture --sequential
# 보안 취약점 분석
/sc:analyze --security --vulnerability
# API 성능 분석
/sc:analyze --api --performance
/sc:cleanup - 코드 정리
불필요한 코드, 파일, 의존성을 정리합니다.
# 기본 코드 정리
/sc:cleanup --code --files
# 전체 안전 정리 (백업 포함)
/sc:cleanup --all --safe --backup
# 의존성 정리
/sc:cleanup --dependencies --interactive
# 특정 영역 정리
/sc:cleanup --code --directory src
/sc:cleanup --imports --formatting
정리 옵션:
-code: 사용하지 않는 변수, 함수 제거-files: 빈 파일, 중복 파일 정리-dependencies: 사용하지 않는 패키지 제거-imports: import 문 정리-comments: 불필요한 주석 제거
/sc:orchestrate - 다중 에이전트 제어
여러 작업을 동시에 관리하고 조율합니다.
# 다중 에이전트 병렬 실행
/sc:orchestrate --multi-agent --parallel
# 순차적 오케스트레이션
/sc:orchestrate --sequential --context
🎭 페르소나 시스템
SuperClaude는 작업 유형에 따라 자동으로 적절한 페르소나를 선택합니다.
주요 페르소나
| 페르소나 | 전문 분야 | 자동 트리거 시점 |
|---|---|---|
| architect | 시스템 설계 | 아키텍처 계획 시 |
| frontend | UI/UX 개발 | 컴포넌트 설계 시 |
| backend | 서버/DB 개발 | API 및 데이터 연동 시 |
| security | 보안 검토 | 보안 분석 시 |
| devops | 배포/운영 | 인프라 작업 시 |
페르소나 수동 지정
# 특정 관점에서 작업
/sc:design --plan --persona-frontend # 프론트엔드 관점 설계
/sc:analyze --api --persona-security # 보안 관점 API 분석
🛠️ 고급 옵션 플래그
계획 및 실행 제어
-plan: 작업 계획 수립 후 검토 단계-sequential: 순차적 실행-iterative: 반복적 개선-interactive: 대화형 실행
효율성 제어
-ultracompressed: 토큰 사용량 최소화 (비용 절약)-magic: 자동 최적화 적용-force-mcp: MCP 강제 사용으로 정확도 향상
안전성 제어
-safe: 안전한 실행 (확실한 것만 변경)-backup: 작업 전 백업 생성-dry-run: 실제 변경 없이 미리보기
세부 제어
-detailed: 상세한 설명 포함-minimal: 최소한의 구조만-scalable: 확장성 고려-secure: 보안 요소 포함
💡 실전 워크플로우
React 대시보드 개발
# 1. 전체 설계 및 계획
/sc:design react-dashboard --type ui --plan
# 2. 컴포넌트 구현
/sc:implement --react --magic
# 3. 코드 품질 검사
/sc:analyze --code-quality --performance
# 4. 최종 정리
/sc:cleanup --all --safe --backup
풀스택 웹 애플리케이션 개발
# 1. 시스템 아키텍처 설계
/sc:design webapp --type architecture --format diagram --plan
# 2. API 설계
/sc:design webapp-api --type api --format spec --restful
# 3. 데이터베이스 설계
/sc:design webapp-db --type database --iterative
# 4. 프론트엔드 구현
/sc:implement --react --component
# 5. 백엔드 구현
/sc:implement --api --database
# 6. 보안 검토
/sc:analyze --security --vulnerability
# 7. 성능 최적화
/sc:analyze --performance --bottlenecks
# 8. 배포 준비
/sc:build --production --optimize
모바일 앱 개발
# 1. 전체 아키텍처 설계
/sc:design mobile-app --type architecture --format diagram --scalable
# 2. UI/UX 설계
/sc:design app-ui --type ui --format wireframe --detailed
# 3. API 연동 설계
/sc:design mobile-api --type api --format spec
# 4. 보안 아키텍처 설계
/sc:design security-layer --type architecture --secure
# 5. 앱 구현
/sc:implement --mobile --native
# 6. 성능 테스트
/sc:analyze --performance --mobile-specific
📊 효과 및 장점
개발 효율성
- 평균 75% 작업 시간 단축
- 버그 70% 감소
- 완성도 30% 향상
주요 장점
- 자동화: 페르소나와 MCP가 컨텍스트에 맞게 자동 선택
- 통합성: 설계부터 구현까지 통합 워크플로우
- 비용 효율:
-ultracompressed옵션으로 토큰 절약 - 품질 향상: 체계적인 분석과 정리 기능
- 학습 효과: 모범 사례가 자동으로 적용
🔗 참고 자료
🎯 시작하기
- 설치:
pip install SuperClaude→SuperClaude install - 첫 프로젝트:
/sc:design --plan으로 시작 - 점진적 학습: 간단한 커맨드부터 고급 기능으로 확장
- 커뮤니티 참여: GitHub에서 최신 정보와 팁 공유
SuperClaude Framework는 Claude Code 사용자라면 반드시 시도해볼 만한 도구입니다. 개발 패러다임의 변화를 경험해보세요! 🚀
![[개념 원리 해설서] AI의 똑똑한 기억법: 필요한 것만 가르치는 ‘컨텍스트 관리’의 마법](/_next/image?url=https%3A%2F%2Fstcwgfbjyvlyshdvojgn.supabase.co%2Fstorage%2Fv1%2Fobject%2Fpublic%2Fpost-images%2Fcovers%2F1776244086953-7bwly4.png&w=3840&q=75)
