SuperClaude 사용법

 

클로드코드 설정 프레임워크인 슈퍼클로드의 사용법 정리글입니다.

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 - 브라우저 자동화 및 테스트

🔗 원본 프로젝트 링크

📦 SuperClaude 설치 (요약)

# 1단계: 패키지 설치
uv add SuperClaude

# 2단계: 설치 프로그램 실행  
python3 -m SuperClaude install

더 자세한 설치 방법은 설치 가이드를 참조하세요.

🤝 기여하기

이 번역 프로젝트에 기여하고 싶으시다면:

  • 🐛 오타나 번역 오류 신고
  • 📝 번역 개선 제안
  • 🔄 최신 문서 업데이트 번역

📄 라이선스

이 번역 프로젝트는 원본 SuperClaude 프로젝트와 동일한 MIT 라이선스를 따릅니다.


원본 제작자: SuperClaude 개발팀
번역: 한국 개발자 커뮤니티를 위한 번역 프로젝트


한국 개발자들이 SuperClaude를 더 쉽게 사용할 수 있기를 바라며 번역했습니다! 🙂