[Claude Code] SuperClaude 사용하기

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

SuperClaude란?

Claude Code를 위한 설정 프레임워크이다.

 

별도의 코드나 외부 도구 없이 순수 설정 파일만으로 Claude Code를 전문적인 개발 어시스턴트로 변신시킨다.

 

커스텀 커맨드, 페르소나, 자동 트리거 기능 등을 제공하여 복잡한 프롬프트 없이 고품질의 결과물을 얻을 수 있도록 도와준다.

 

 

설치하기

pipx 설치하기

python으로 작성된 CLI를 시스템 환경과 격리된 독립적인 가상 환경에 안전하게 설치하고 실행할 수 있게 해주는 도구이다.

brew install pipx

 

SuperClaudea 설치하기

pipx로 설치하기 (공식 문서 추천)

# superclaude 설치
pipx install superclaude

 

github로 설치하기

# git clone 받기
git clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git
cd SuperClaude_Framework

# 명령어 실행
./install.sh

 

SuperClaude 기능 설치

# commands 설치
superclaude install

# mcp 목록 확인
superclaude mcp --list

# mcp 대화형 설치 (옵션)
superclaude mcp

# mcp 선택 설치 (옵션)
supercluade mcp --servers tavily --servers context7

# 설치 확인
superclaude install --list
superclaude doctor

 

 

사용하기

Super Claude 에서 사용 가능한 커멘드는 여러 개 있지만 공식 문서에 소개된 핵심 커멘드를 정리해봤다.

명령어	목적	예시
/sc:brainstorm	대화형 요구 사항 발견 및 프로젝트 계획	▪︎ 새 프로젝트 계획 /sc:brainstorm "프로젝트 계획" ▪︎ 기능 탐색 /sc:brainstorm "구현 기능" ▪︎ 문제 해결 /sc:brainstorm "이슈 사항"
/sc:help	사용 가능한 명령어 발견 및 이름 확인	/sc:help
/sc:research	적응형 계획 및 지능형 검색을 통한 포괄적인 웹 연구	▪︎ 기술 연구 /sc:research "최신 React 기능" --depth deep ▪︎ 시장 분석 /sc:research "AI 코딩 근황" --stategy unified ▪︎ 학술 조사   /sc:research "양자 컴퓨팅" --depth exhaustive ▪︎ 최신 정보  /sc:research "최신 AI 개발"
/sc:implement	지능형 전문가 라우팅을 통한 풀스택 기능 개발	▪︎ 인증   /sc:implement "JWT 로그인 시스템" ▪︎ UI 컴포넌트  /sc:implement "반응형 대시보드" ▪︎ API  /sc:implement "REST 사용자 엔드포인트" ▪︎ 데이터베이스  /sc:implement "관계를 가진 사용자 스키마"
/sc:analyze	품질, 보안, 성능에 걸친 포괄적인 코드 분석	▪︎ 프로젝트 상태  /sc:analyze . ▪︎ 보안 검사  /sc:analyze --focus security ▪︎ 성능 검토  /sc:analyze --focus performance
/sc:spec-panel	저명한 사양 및 소프트웨어 엔지니어링 전문가를 사용한 다중 전문가 사양 검토 및 개선	▪︎ 사양 검토  /sc:spec-panel @api_spc.yml --mode critique --force requirements, architecture ▪︎ 요구사항 워크숍  /sc:spec-panel "스토리 내용" --mode discussion ▪︎ 아키텍처 검증  /sc:spec-panel @microservice.spec.yml --mode socratic --focus compliance ▪︎ 규정 준수 검토  /sc:spec-panel @security_requirement.yml --focus architecture ▪︎ 반복적 개선  /sc:spec-panel @complex_system.spec.yml --iterations 3
/sc:troubleshoot	근본 원인 분석을 통한 체계적인 문제 진단	▪︎ 런타임 오류  /sc:troubleshoot "로그인 시 500 오류" ▪︎ 빌드 실패  /sc:troubleshoot --type build ▪︎ 성능 문제  /sc:troubleshoot "느린 페이지 로드"
/sc:test	커버리지 분석을 통한 포괄적인 테스팅	▪︎ 전체 테스트 스위트  /sc:test --coverage ▪︎ 단위 테스팅  /sc:test --type unit --watch ▪︎ E2E 검증  /sc:test --type e2e
/sc:improve	체계적인 코드 개선 및 최적화 적용	▪︎ 일반적인 개선  /sc:improve src/ ▪︎ 성능 최적화  /sc:improve --type performance ▪︎ 보안 강화  /sc:improve --type security
/sc:document	코드 및 API에 대한 포괄적인 문서 생성	▪︎ API 문서  /sc:document --type api ▪︎ 사용자 가이드  /sc:document --type user-guide ▪︎ 기술 문서  /sc:document --type technical
/sc:design	시스템 아키텍처, API 및 구성 요소 인터페이스를 포괄적인 명세와 함께 설계	▪︎ 시스템 아키텍처 설계  /sc:design --architecture --modern --scalable ▪︎ API  설계  /sc:design --api --ddd ▪︎ 데이터베이스 스키마 설계 /sc:design --database --postgresql --relations
/sc:workflow	요구사항에서 구조화된 구현 계획 생성	▪︎ 기능 계획  /sc:workflow "사용자 인증" ▪︎ 스프린트 계획  /sc:workflow --strategy agile ▪︎ 아키텍처 계획  /sc:workflow "마이크로서비스 마이그레이션"

 

위 커멘드 외에도 사용할 수 있는 다양한 커멘드가 존재하니 공식 문서의 유저 가이드를 참고해서 사용하면 된다.

 

 

참고 사이트

https://github.com/SuperClaude-Org/SuperClaude_Framework

GitHub - SuperClaude-Org/SuperClaude_Framework: A configuration framework that enhances Claude Code with specialized commands, c

 

https://github.com/SuperClaude-Org/SuperClaude_Framework/blob/master/docs/user-guide-kr/commands.md

SuperClaude_Framework/docs/user-guide-kr/commands.md at master · SuperClaude-Org/SuperClaude_Framework

 

https://goddaehee.tistory.com/387

Claude Code + SuperClaude 조합 : SuperClaude 설치 방법 (/sc: 커맨드로 개발 효율성 올리기)

 

https://javaexpert.tistory.com/1349

Claude code 확장팩 : SuperClaude Framework

 

https://www.youtube.com/watch?v=4ndOjpo2wS4