🚀 SuperClaude Framework 명령어 조합 방식(초보자 가이드)
📋 목차
- 기본 개념
- 문제 해결 워크플로우
- 주요 명령어 치트시트
- 실전 예제
🎯 기본 개념
SuperClaude가 작동하는 방식
┌─────────────────┐
│ 당신이 입력 │
│ /sc:command │
└────────┬────────┘
│
▼
┌─────────────────┐
│ Claude Code │ ← 프레임워크 설정 파일을 읽음
│ 컨텍스트 읽기 │ (~/.claude/ 폴더)
└────────┬────────┘
│
▼
┌─────────────────┐
│ 향상된 AI 응답 │ ← 전문가 모드로 답변
│ (전문가 모드) │
└─────────────────┘
🔧 문제 해결 워크플로우
⚡ 간단한 3단계 프로세스
📖 주요 명령어 치트시트
🆘 문제 해결 명령어
명령어 용도 예제
| /sc:troubleshoot | 문제 진단 및 분석 | /sc:troubleshoot "앱이 느려요" |
| /sc:analyze | 코드/시스템 심층 분석 | /sc:analyze src/components/ |
| /sc:improve | 코드 개선 및 최적화 | /sc:improve --safe-mode |
| /sc:test | 테스트 생성 및 실행 | /sc:test --coverage |
🛠️ 개발 명령어
명령어 용도 예제
| /sc:implement | 기능 구현 | /sc:implement "로그인 기능" |
| /sc:build | 프로젝트 빌드 | /sc:build --react |
| /sc:document | 문서 생성 | /sc:document src/api.js |
| /sc:brainstorm | 아이디어 발굴 | /sc:brainstorm "새 기능 아이디어" |
🔍 분석 명령어
명령어 용도 예제
| /sc:research | 웹 리서치 | /sc:research "React 최신 트렌드" |
| /sc:explain | 개념 설명 | /sc:explain "클로저란?" |
| /sc:estimate | 작업 시간 추정 | /sc:estimate "새 기능 개발" |
⚙️ 유용한 플래그 (옵션)
플래그 설명 언제 사용?
| --safe-mode | 안전한 변경 모드 | 중요한 코드 수정 시 |
| --preview | 미리보기 (실행X) | 변경사항 확인 후 적용 |
| --think | 심층 사고 모드 | 복잡한 문제 분석 |
| --verbose | 상세 출력 | 디버깅 정보 필요 시 |
👤 전문가 에이전트 (직접 호출 가능)
에이전트 전문 분야 예제
| @agent-security | 보안 분석 | @agent-security "코드 보안 검토" |
| @agent-frontend | 프론트엔드 개발 | @agent-frontend "UI 개선" |
| @agent-performance | 성능 최적화 | @agent-performance "속도 개선" |
| @agent-architect | 시스템 설계 | @agent-architect "아키텍처 리뷰" |
💡 실전 예제
시나리오 1: 버그 발견했을 때
단계별 실행:
1️⃣ 문제 파악
/sc:troubleshoot "로그인 시 에러 발생"
2️⃣ 코드 분석
/sc:analyze src/auth/login.js
3️⃣ 안전하게 수정
/sc:improve src/auth/login.js --safe-mode
4️⃣ 테스트
/sc:test src/auth/ --coverage
시나리오 2: 새 기능 개발할 때
🚀 추천 워크플로우:
1️⃣ 아이디어 정리
/sc:brainstorm "사용자 프로필 페이지"
2️⃣ 기능 구현
/sc:implement "프로필 페이지 UI"
3️⃣ 코드 리뷰
/sc:analyze components/Profile.jsx
4️⃣ 문서 작성
/sc:document components/Profile.jsx --type guide
5️⃣ 테스트
/sc:test components/Profile.jsx
시나리오 3: 성능 문제 해결
⚡ 성능 최적화 프로세스:
1️⃣ 성능 분석
/sc:analyze --focus performance
2️⃣ 전문가 호출
@agent-performance "앱이 너무 느려요"
3️⃣ 개선 적용
/sc:improve --focus performance --safe-mode
4️⃣ 변경사항 확인
/sc:analyze --focus performance
시나리오 4: 보안 점검
🔒 보안 체크리스트:
1️⃣ 보안 스캔
@agent-security "전체 코드 보안 검토"
2️⃣ 취약점 분석
/sc:analyze --focus security
3️⃣ 안전하게 수정
/sc:improve --safe-mode --validate
4️⃣ 재검증
@agent-security "수정 후 재검토"
시나리오 5: 프로젝트 리서치
📚 리서치 깊이 선택:
기본 (2분):
/sc:research "React 18 새 기능"
표준 (5분):
/sc:research "React 18 새 기능" --depth standard
심층 (8분):
/sc:research "React 18 새 기능" --depth deep
전문가 수준 (10분+):
/sc:research "React 18 새 기능" --depth exhaustive
🎓 팁과 요령
✅ 권장 사항
1. 간단한 명령부터 시작
/sc:analyze README.md ← 이렇게 먼저!
2. 필요할 때만 플래그 추가
/sc:analyze src/ ← 기본
/sc:analyze src/ --think ← 복잡할 때
3. 안전 모드 습관화
/sc:improve --safe-mode ← 항상 이렇게!
4. 전문가 에이전트 활용
@agent-security "보안 검토" ← 특정 분야는 전문가에게
❌ 피해야 할 것
1. 터미널에서 /sc: 명령어 실행 ❌
→ Claude Code 채팅창에서만 사용!
2. 여러 플래그 한번에 사용 ❌
/sc:analyze --think --verbose --safe-mode --preview
→ 필요한 것만 선택!
3. --introspect 플래그 사용 ❌
→ V4에서는 제거됨 (V3 전용)
4. /sc:load, /sc:spawn 같은 고급 명령어 처음부터 사용 ❌
→ 기본 명령어 익숙해진 후 사용
🆘 자주 묻는 질문
Q1: 명령어가 작동하지 않아요!
확인 사항:
1. Claude Code 채팅창에서 실행했나요?
✅ Claude Code Chat
❌ 터미널/CMD
2. 설치가 제대로 되었나요?
python3 -m SuperClaude --version
(예상 출력: SuperClaude 4.x.x)
3. V3에서 V4로 업그레이드했나요?
→ ~/.claude/ 폴더 정리 필요
Q2: 어떤 명령어부터 시작해야 하나요?
추천 순서:
1. /sc:help
→ 사용 가능한 모든 명령어 보기
2. /sc:brainstorm "간단한 아이디어"
→ 대화형 인터페이스 체험
3. /sc:analyze README.md
→ 파일 분석 기능 체험
4. /sc:troubleshoot "테스트 문제"
→ 문제 해결 프로세스 체험
Q3: 플래그는 언제 사용하나요?
플래그 사용 시점:
기본 명령으로 시작:
/sc:analyze src/
결과가 불충분하면 플래그 추가:
/sc:analyze src/ --think
아직 부족하면 더 추가:
/sc:analyze src/ --think --verbose
→ 점진적으로 복잡도 증가!
🎯 핵심 요약
┌─────────────────────────────────────────┐
│ │
│ SuperClaude = Claude Code + 전문가 AI │
│ │
│ 기본: /sc:command │
│ 고급: /sc:command --flag │
│ 전문가: @agent-name │
│ │
│ 항상: Claude Code 채팅창에서 실행! │
│ │
└─────────────────────────────────────────┘
가장 많이 쓰는 조합 Top 5
1. /sc:troubleshoot "문제" → /sc:analyze 경로/ → /sc:improve --safe-mode
2. /sc:brainstorm "아이디어" → /sc:implement "기능"
3. /sc:research "주제" --depth deep
4. @agent-security "보안 검토" → /sc:improve --safe-mode
5. /sc:analyze 파일 --think → /sc:document 파일
📚 추가 학습 자료
공식 문서:
- Commands: https://github.com/SuperClaude-Org/SuperClaude_Framework/blob/master/Docs/User-Guide/commands.md
- 설치 가이드: https://github.com/SuperClaude-Org/SuperClaude_Framework/blob/master/Docs/Getting-Started/installation.md
- 버그 수정 상세: https://tilnote.io/pages/68fe2eb6b2a9b09688b606f7
도움말:
- /sc:help ← 모든 명령어 목록
- /sc:analyze --help ← 특정 명령어 도움말✨ 마지막 조언
1. 천천히 시작하세요 - 한 번에 하나씩!
2. 실험해보세요 - 망가지지 않아요!
3. 문서를 읽으세요 - /sc:help 활용!
4. 커뮤니티에 질문하세요 - GitHub Issues!
Happy Coding with SuperClaude! 🚀
