Tools
Claude Code
Super Claude
Superclaude User Guide Kr

SuperClaude 사용자 가이드 🚀

🎯 간단한 진실

명백한 복잡성 뒤에는 SuperClaude가 실제로 사용하기 쉽습니다. 모든 명령어, 플래그, 페르소나를 배울 필요가 없습니다. 그냥 사용하기 시작하세요! 🎈

SuperClaude에는 지능형 라우팅 시스템이 있어 필요한 것을 파악하려고 합니다:

  • /analyze some-code/를 입력 → 적절한 분석 도구를 선택
  • 보안에 대해 질문 → 보안 전문가 자동 활성화
  • 프론트엔드 작업 → UI 전문가가 담당
  • 무언가 디버그 → 조사 모드 시작

학습은 사용 중에 나타납니다 - 매뉴얼을 먼저 공부하지 않고도 자연스럽게 무엇이 작동하는지 발견할 것입니다.

아래의 자세한 가이드? 원할 때 이해하고 싶을 때 또는 더 깊이 들어가고 싶을 때를 위해 있습니다. 하지만 솔직히? 대부분의 경우 그냥 즉흥적으로 할 수 있습니다. 😊

TL;DR: 설치하고, 코드에 /analyze나 /build를 시도하고, 마법이 일어나는 것을 보세요.

SuperClaude v3.0을 효과적으로 이해하고 사용하기 위한 포괄적인 가이드입니다. 하지만 기억하세요 - 바로 시도해볼 수 있습니다!

목차 📖

🚀 여기서 바로 시작하세요

읽기를 건너뛰고 바로 뛰어들고 싶으신가요? 2분 시작 가이드입니다:

# Claude Code에서 다음 명령어를 시도하세요:
 
/sc:help                          # 사용 가능한 것 보기
/sc:analyze README.md             # SuperClaude가 프로젝트 분석
/sc:workflow feature-prd.md       # PRD에서 구현 워크플로 생성 (신규!)
/sc:implement user-auth           # 기능과 컴포넌트 생성 (v3에서 신규!)
/sc:build                         # 자동 최적화로 스마트 빌드
/sc:improve messy-file.js         # 코드 자동 정리

방금 무슨 일이 일어났나요? SuperClaude가 자동으로:

  • 각 작업에 적합한 도구 선택 🛠️
  • 적절한 전문가 활성화 (보안, 성능 등) 🎭
  • 지능적인 플래그와 최적화 적용 ⚡
  • 증거 기반 제안 제공 📊

얼마나 쉬웠는지 보셨나요? 공부할 필요 없음 - SuperClaude가 복잡성을 파악하므로 여러분은 그럴 필요가 없습니다.

작동 방식을 이해하고 싶으신가요? 계속 읽어보세요. 계속 실험하고 싶으신가요? 그렇게 하세요! 🎯

환영 및 개요

SuperClaude가 정말 무엇인가요? 🤔

SuperClaude는 개발 작업을 위해 Claude Code를 더 똑똑하게 만듭니다. 일반적인 응답 대신, 자신의 분야를 아는 다양한 전문가(보안, 성능, 프론트엔드 등)로부터 전문적인 도움을 받습니다.

솔직한 진실: 방금 v3.0을 출시했고 베타에서 갓 나왔습니다. 하는 일에 꽤 잘 작동하지만 계속 개선하면서 일부 거친 부분이 예상됩니다. 실제 소프트웨어 개발 워크플로에 Claude Code가 더 도움이 되기를 원했기 때문에 이것을 만들었습니다.

멋진 부분? 이 복잡성을 관리할 필요가 없습니다. /analyze나 /build와 같은 일반 명령어를 사용하면 SuperClaude가 보통 어떤 전문가를 참여시키고 어떤 도구를 사용할지 파악합니다. 🪄

SuperClaude가 추가하는 것 ✨

🛠️ 17개의 특수 명령어

  • 계획 도구: /workflow (신규!), /estimate, /task
  • 개발 도구: /implement, /build, /design
  • 분석 도구: /analyze, /troubleshoot, /explain
  • 품질 도구: /improve, /cleanup, /test
  • 문서화, git, 배포 등을 위한 유틸리티
  • 그냥 사용하세요 - SuperClaude가 복잡성을 자동으로 처리합니다
  • 신규: PRD-to-구현 계획을 위한 /workflow 명령어
  • 신규: 기능 생성을 위한 /implement 명령어 (v2 기능 복원)

🎭 11개의 스마트 페르소나 (언제 뛰어들지 아는)

  • 다양한 도메인에 맞게 동작을 적응시키는 AI 전문가
  • 요청에 따라 자동 활성화 (보안 작업에는 보안 전문가 등)
  • 수동 제어 가능하지만 보통 필요하지 않음
  • 언제 도와야 할지 아는 전체 개발 팀을 갖는 것으로 생각하세요

🔧 MCP 서버 통합 (스마트 외부 도구)

  • Context7: 공식 라이브러리 문서 조회
  • Sequential: 복잡한 다단계 분석
  • Magic: 최신 UI 컴포넌트 생성
  • Playwright: 브라우저 자동화 및 테스트
  • 필요할 때 자동 연결 - 이런 것들을 관리하지 않습니다

📋 향상된 작업 관리 (배후에서 발생)

  • TodoRead/TodoWrite로 진행 상황 추적
  • /task로 다중 세션 프로젝트 관리
  • /spawn으로 복잡한 오케스트레이션
  • /loop로 반복적 개선
  • 대부분 자동 - SuperClaude가 하고 있는 일을 추적합니다

⚡ 토큰 최적화 (스마트 효율성)

  • 컨텍스트가 가득 찰 때 스마트 압축
  • 효율적인 커뮤니케이션을 위한 기호 시스템
  • 대규모 작업을 위한 성능 최적화
  • 대규모 프로젝트에 필요할 때 보통 활성화

문제 해결

일반적인 문제

"명령어가 작동하지 않음"

  • 철자 확인 (/sc:analyze가 아닌 /analyze)
  • Claude Code가 업데이트되었는지 확인
  • SuperClaude가 올바르게 설치되었는지 확인

"자동 활성화가 잘못됨"

  • 플래그로 수동 재정의: --persona-security
  • 더 구체적인 키워드 사용
  • 명령에 컨텍스트 추가

도움 받기

여전히 문제가 있는 경우:

  • /sc:help 확인
  • 설치 가이드 검토
  • GitHub 문제 확인
  • 버그 보고서 제출

다음 단계

SuperClaude는 개발 워크플로를 향상시키기 위해 설계되었습니다. 완벽하지는 않지만 계속 개선하고 있습니다. 여러분의 피드백과 경험이 더 나아지는 데 도움이 됩니다.

기억하세요: 이 모든 복잡성 뒤에는 SuperClaude가 여러분의 삶을 더 쉽게 만들려고 합니다. 그것을 위해 노력하지 마세요 - 그것이 여러분을 위해 일하도록 하세요. 🚀

즐거운 코딩되세요! ✨

Superclaude Docs KrClaude Code Tips