클로드코드 설정 프레임워크인 슈퍼클로드의 사용법 정리글입니다.
SuperClaude 한국어 문서 📚🇰🇷
SuperClaude v3 공식 문서의 한국어 번역 프로젝트
🎯 프로젝트 소개
이 프로젝트는 SuperClaude v3의 공식 문서를 한국어로 번역하여 한국 개발자 커뮤니티에 제공하기 위한 프로젝트입니다.
SuperClaude란? 🤔
SuperClaude는 Claude Code를 개발 작업에 더 유용하게 만들어주는 프레임워크입니다:
- 🛠️ 17개의 전문 명령어 - 일반적인 개발 작업을 위한 특화된 도구들
- 🎭 스마트 페르소나 - 다양한 도메인에 맞는 전문가가 자동으로 선택됩니다
- 🔧 MCP 서버 통합 - 문서, UI 컴포넌트, 브라우저 자동화 등
- 📋 작업 관리 - 진행 상황을 추적하고 관리
- ⚡ 토큰 최적화 - 더 긴 대화를 위한 효율적인 토큰 사용
🔥 복잡한 사용 커맨드 예시
실제 개발 현장에서 SuperClaude의 여러 기능을 조합해서 사용하는 실용적인 예시들입니다:
🛡️ 보안 취약점 종합 분석 및 수정
# 1단계: 보안 전문가가 전체 시스템 분석
/sc:analyze auth-system/ --persona-security --focus security --validate --seq
# 2단계: 발견된 취약점을 체계적으로 수정
/sc:implement "JWT 토큰 보안 강화" --persona-security --persona-backend --safe-mode --think
# 3단계: 보안 테스트 및 문서화
/sc:test security-suite --persona-qa --persona-security --validate
/sc:document security-fixes/ --persona-scribe --persona-security
시나리오: 인증 시스템의 보안 취약점을 발견하고 체계적으로 수정하는 과정
활용되는 기능: Security + Backend 페르소나, Sequential MCP, 안전 모드, 검증 플래그
⚡ 성능 최적화 프로젝트
# 1단계: 성능 병목 현상 심층 분석
/sc:analyze --persona-performance --focus performance --ultrathink --all-mcp
# 2단계: 프론트엔드 + 백엔드 통합 최적화
/sc:improve slow-components/ --persona-performance --persona-frontend --magic --concurrency 3
# 3단계: 데이터베이스 쿼리 최적화
/sc:improve database-queries/ --persona-performance --persona-backend --seq --validate
# 4단계: 성능 테스트 및 검증
/sc:test performance-suite --persona-performance --persona-qa --coverage
시나리오: 웹 애플리케이션의 전반적인 성능을 체계적으로 최적화
활용되는 기능: Performance + Frontend + Backend 페르소나, Magic MCP, 동시성 처리
🎨 모던 프론트엔드 컴포넌트 개발
# 1단계: UI 컴포넌트 설계 및 아키텍처 계획
/sc:design "반응형 대시보드 컴포넌트" --persona-architect --persona-frontend --magic --think-hard
# 2단계: 접근성을 고려한 컴포넌트 구현
/sc:implement dashboard-components/ --persona-frontend --magic --focus accessibility --validate
# 3단계: 품질 보증 및 테스트
/sc:test component-suite --persona-qa --persona-frontend --play
/sc:improve --focus accessibility components/ --persona-frontend --validate
시나리오: 현대적이고 접근성이 우수한 UI 컴포넌트 개발
활용되는 기능: Architect + Frontend 페르소나, Magic MCP, Playwright, 접근성 집중
🔧 백엔드 API 개발 및 자동 배포
# 1단계: RESTful API 아키텍처 설계
/sc:design "사용자 관리 API" --persona-architect --persona-backend --seq --c7
# 2단계: 보안을 고려한 API 구현
/sc:implement user-api/ --persona-backend --persona-security --safe-mode --validate
# 3단계: 자동화된 배포 파이프라인 구축
/sc:implement deployment-pipeline --persona-devops --persona-backend --think --validate
# 4단계: 모니터링 및 문서화
/sc:document api-docs/ --persona-scribe --c7
/sc:implement monitoring-setup --persona-devops --seq
시나리오: 보안이 강화된 API를 개발하고 자동 배포 환경까지 구축
활용되는 기능: 다중 페르소나 협업, Context7 MCP, Sequential MCP, 안전 모드
🧹 레거시 코드 현대화 프로젝트
# 1단계: 레거시 코드 품질 분석
/sc:analyze legacy-modules/ --persona-analyzer --persona-refactorer --seq --ultrathink
# 2단계: 단계적 리팩토링 계획 수립
/sc:design "모듈 현대화 로드맵" --persona-architect --persona-refactorer --think-hard --seq
# 3단계: 테스트 커버리지 확보 후 리팩토링
/sc:test legacy-modules/ --persona-qa --focus coverage
/sc:cleanup legacy-modules/ --persona-refactorer --safe-mode --validate
# 4단계: 성능 검증 및 문서화
/sc:test refactored-modules/ --persona-performance --persona-qa --coverage
/sc:document refactoring-guide/ --persona-mentor --persona-scribe
시나리오: 레거시 코드를 안전하게 현대화하면서 품질과 성능을 향상
활용되는 기능: 분석가 + 리팩토링 전문가 협업, 안전 모드, 단계적 접근
🔍 복잡한 프로덕션 버그 해결
# 1단계: 체계적인 근본 원인 분석
/sc:troubleshoot "사용자 세션이 무작위로 만료" --persona-analyzer --seq --ultrathink --all-mcp
# 2단계: 다각도 시스템 분석 (보안 + 백엔드)
/sc:analyze session-management/ --persona-security --persona-backend --focus security
/sc:analyze performance-logs/ --persona-performance --focus performance
# 3단계: 종합적인 해결책 구현
/sc:implement session-fix --persona-backend --persona-security --safe-mode --validate
# 4단계: 재발 방지 및 모니터링
/sc:implement monitoring-alerts --persona-devops --validate
/sc:document incident-report --persona-scribe --persona-analyzer
시나리오: 프로덕션 환경의 복잡한 문제를 체계적으로 해결
활용되는 기능: 다중 전문가 협업, Sequential MCP, 모든 MCP 활용, 근본 원인 분석
📖 번역된 문서 목록
핵심 가이드
-
사용자 가이드 - SuperClaude 전반적인 사용법과 개요
SuperClaude v3.0의 핵심 구성요소(명령어, 플래그, 페르소나, MCP 서버)를 소개하고,
지능적 라우팅 시스템을 통해 복잡해 보이지만 실제로는 사용하기 쉬운 구조를 설명합니다.
초보자도 쉽게 시작할 수 있도록 기본 워크플로우와 실제 사용 예시를 제공합니다. -
설치 가이드 - 단계별 설치 과정 및 옵션
SuperClaude v3.0의 다양한 설치 방법(PyPI, 소스, uv/uvx)을 상세히 설명합니다.
2단계 설치 과정(패키지 설치 → 설치 프로그램 실행)과 설치 프로필(minimal, quick, developer)을 안내하며,
v2에서 v3로 업그레이드하는 사용자를 위한 마이그레이션 가이드도 포함되어 있습니다.
상세 가이드
-
명령어 가이드 - 16개 슬래시 명령어 완전 가이드
SuperClaude의 16개 전문 명령어를 용도별로 분류하여 상세히 설명합니다.
각 명령어의 자동 활성화 패턴, 유용한 플래그, 실제 사용 예시를 제공하며,
명령어를 외울 필요 없이 SuperClaude가 상황에 맞는 도구를 자동 선택한다는 점을 강조합니다. -
플래그 가이드 - 명령어 플래그와 옵션 시스템
SuperClaude의 플래그 시스템이 명령어 동작을 어떻게 수정하는지 설명합니다.
대부분의 플래그가 컨텍스트에 따라 자동으로 활성화되어 수동 개입을 최소화한다는 점을 강조하며,
계획, 효율성, MCP 제어, 오케스트레이션, 집중 등 목적별로 플래그를 분류하여 설명합니다. -
페르소나 가이드 - 11명의 AI 전문가 페르소나 시스템
SuperClaude의 11명 AI 전문가가 각각 다른 개발 영역에 특화되어 있음을 설명합니다.
페르소나가 컨텍스트에 따라 자동으로 활성화되어 전문가 수준의 도움을 제공하며,
각 페르소나의 전문 분야, 우선순위, 활성화 조건, 워크플로우 예시를 상세히 다룹니다.
🚀 SuperClaude 주요 기능
명령어 시스템 🛠️
개발: /sc:implement
, /sc:build
, /sc:design
분석: /sc:analyze
, /sc:troubleshoot
, /sc:explain
품질: /sc:improve
, /sc:test
, /sc:cleanup
기타: /sc:document
, /sc:git
, /sc:estimate
, /sc:task
, /sc:index
, /sc:load
, /sc:spawn
AI 전문가 페르소나 🎭
- 🏗️ architect - 시스템 설계 및 아키텍처
- 🎨 frontend - UI/UX 및 접근성
- ⚙️ backend - API 및 인프라
- 🔍 analyzer - 디버깅 및 문제 해결
- 🛡️ security - 보안 및 취약점 분석
- ✍️ scribe - 문서 작성 및 글쓰기
- ⚡ performance - 최적화 및 병목 현상 해결
- 🧪 qa - 품질 보증 및 테스팅
- 🔄 refactorer - 코드 품질 및 정리
- 🚀 devops - 인프라 및 배포 자동화
- 👨🏫 mentor - 교육 및 지식 전수
MCP 통합 🔧
- Context7 - 공식 라이브러리 문서 및 패턴 검색
- Sequential - 복잡한 다단계 사고 프로세스 지원
- Magic - 모던 UI 컴포넌트 생성
- Playwright - 브라우저 자동화 및 테스트
🔗 원본 프로젝트 링크
- 공식 GitHub: SuperClaude Framework
- 공식 웹사이트: SuperClaude Website
- PyPI 패키지: SuperClaude on PyPI
📦 SuperClaude 설치 (요약)
# 1단계: 패키지 설치
uv add SuperClaude
# 2단계: 설치 프로그램 실행
python3 -m SuperClaude install
더 자세한 설치 방법은 설치 가이드를 참조하세요.
🤝 기여하기
이 번역 프로젝트에 기여하고 싶으시다면:
- 🐛 오타나 번역 오류 신고
- 📝 번역 개선 제안
- 🔄 최신 문서 업데이트 번역
📄 라이선스
이 번역 프로젝트는 원본 SuperClaude 프로젝트와 동일한 MIT 라이선스를 따릅니다.
원본 제작자: SuperClaude 개발팀
번역: 한국 개발자 커뮤니티를 위한 번역 프로젝트
한국 개발자들이 SuperClaude를 더 쉽게 사용할 수 있기를 바라며 번역했습니다! 🙂