SuperClaude/README-kr.md

🚀 SuperClaude 프레임워크

Claude Code를 구조화된 개발 플랫폼으로 변환

빠른 시작 • 후원 • 새로운 기능 • 문서 • 기여

---

📊 프레임워크 통계

명령어 수	에이전트	모드	MCP 서버
21	14	5	6
슬래시 명령어	전문 AI	작동 모드	통합 서비스

---

🎯 개요

SuperClaude는 메타프로그래밍 설정 프레임워크로, 동작 지시 주입과 컴포넌트 통제를 통해 Claude Code를 구조화된 개발 플랫폼으로 변환합니다. 강력한 도구와 지능형 에이전트를 갖춘 체계적인 워크플로우 자동화를 제공합니다.

⚡ 빠른 설치

설치 방법 선택

방법	명령어	최적 사용처
🐍 pipx	pipx install SuperClaude && pipx upgrade SuperClaude && SuperClaude install	✅ 권장 - Linux/macOS
📦 pip	pip install SuperClaude && pip upgrade SuperClaude && SuperClaude install	기존 Python 환경
🌐 npm	npm install -g @bifrost_inc/superclaude && superclaude install	크로스 플랫폼, Node.js 사용자

⚠️ 중요: SuperClaude V3에서 업그레이드

SuperClaude V3가 설치되어 있다면 V4를 설치하기 전에 제거해야 합니다:

# 먼저 V3 제거
관련된 모든 파일과 디렉토리 삭제:
*.md *.json 및 commands/

# 그런 다음 V4 설치
pipx install SuperClaude && pipx upgrade SuperClaude && SuperClaude install

✅ 업그레이드 시 유지되는 내용:

• ✓ 커스텀 슬래시 명령어 (commands/sc/ 외부)
• ✓ CLAUDE.md 내의 커스텀 콘텐츠
• ✓ Claude Code의 .claude.json, .credentials.json, settings.json, settings.local.json
• ✓ 추가한 커스텀 에이전트 및 파일

⚠️ 참고: V3의 다른 SuperClaude 관련 .json 파일은 충돌을 일으킬 수 있으므로 삭제하세요.

💡 PEP 668 오류 해결방법

# 옵션 1: pipx 사용 (권장)
pipx install SuperClaude

# 옵션 2: 사용자 설치
pip install --user SuperClaude

# 옵션 3: 강제 설치 (주의해서 사용)
pip install --break-system-packages SuperClaude

---

💖 프로젝트 후원하기

솔직히 말씀드리면, SuperClaude를 유지하는 데는 시간과 리소스가 필요합니다.

테스트를 위한 Claude Max 구독료만 매월 100달러이고, 거기에 문서화, 버그 수정, 기능 개발에 쓰는 시간이 추가됩니다. 일상 업무에서 SuperClaude의 가치를 느끼신다면, 프로젝트 후원을 고려해주세요. 몇 달러라도 기본 비용을 충당하고 개발을 계속할 수 있게 해줍니다.

코드, 피드백, 또는 후원을 통해, 모든 기여자가 중요합니다. 이 커뮤니티의 일원이 되어주셔서 감사합니다! 🙏

☕ Ko-fi 일회성 기여

🎯 Patreon 월간 후원

💜 GitHub 유연한 티어

여러분의 후원으로 가능한 것들:

항목	비용/영향
🔬 Claude Max 테스트	검증과 테스트를 위해 월 100달러
⚡ 기능 개발	새로운 기능과 개선 사항
📚 문서화	포괄적인 가이드와 예제
🤝 커뮤니티 지원	신속한 이슈 대응과 도움
🔧 MCP 통합	새로운 서버 연결 테스트
🌐 인프라	호스팅 및 배포 비용

참고: 하지만 부담은 없습니다. 프레임워크는 어쨌든 오픈소스로 유지됩니다. 사람들이 사용하고 가치를 느끼고 있다는 것만 알아도 동기부여가 됩니다. 코드, 문서, 또는 정보 확산을 통한 기여도 큰 도움이 됩니다! 🙏

---

🎉 V4의 새로운 기능

버전 4는 커뮤니티 피드백과 실제 사용 패턴을 기반으로 중요한 개선 사항을 제공합니다.

🤖 더 스마트한 에이전트 시스템 14개의 전문 에이전트가 도메인 전문성을 제공: 보안 엔지니어가 실제 취약점 포착 프론트엔드 아키텍트가 UI 패턴 이해 컨텍스트 기반 자동 조정 필요 시 도메인별 전문 지식 제공	📝 개선된 네임스페이스 모든 명령어에 /sc: 접두사: 커스텀 명령어와 충돌 없음 전체 라이프사이클을 다루는 21개 명령어 브레인스토밍부터 배포까지 정리된 명령어 구조
🔧 MCP 서버 통합 6개의 강력한 서버가 함께 작동: Context7 → 최신 문서 Sequential → 복잡한 분석 Magic → UI 컴포넌트 생성 Playwright → 브라우저 테스트 Morphllm → 대량 변환 Serena → 세션 지속성	🎯 작동 모드 다양한 컨텍스트를 위한 5가지 적응형 모드: 브레인스토밍 → 적절한 질문하기 오케스트레이션 → 효율적인 도구 조정 토큰 효율성 → 30-50% 컨텍스트 절약 작업 관리 → 체계적인 구성 성찰 → 메타인지 분석
⚡ 최적화된 성능 더 작은 프레임워크, 더 큰 프로젝트: 프레임워크 풋프린트 감소 코드를 위한 더 많은 컨텍스트 더 긴 대화 가능 복잡한 작업 활성화	📚 문서 전면 개편 개발자를 위한 완전한 재작성: 실제 예제와 사용 사례 일반적인 함정 문서화 실용적인 워크플로우 포함 개선된 탐색 구조

---

📚 문서

🇰🇷 SuperClaude 완전 한국어 가이드

🚀 시작하기	📖 사용자 가이드	🛠️ 개발자 리소스	📋 레퍼런스
📝 빠른 시작 가이드 즉시 시작하기 💾 설치 가이드 상세한 설정 단계	🎯 명령어 레퍼런스 전체 21개 슬래시 명령어 🤖 에이전트 가이드 14개 전문 에이전트 🎨 작동 모드 5가지 적응형 모드 🚩 플래그 가이드 동작 제어 매개변수 🔧 MCP 서버 6개 서버 통합 💼 세션 관리 상태 저장 및 복원	🏗️ 기술 아키텍처 시스템 설계 세부사항 💻 코드 기여 개발 워크플로우 🧪 테스트 및 디버깅 품질 보증	✨ 모범 사례 전문가 팁과 패턴 📓 예제 모음 실제 사용 예제 🔍 문제 해결 일반적인 문제와 수정

---

🤝 기여하기

SuperClaude 커뮤니티에 참여하세요

모든 종류의 기여를 환영합니다! 도움을 줄 수 있는 방법:

우선순위	영역	설명
📝 높음	문서	가이드 개선, 예제 추가, 오타 수정
🔧 높음	MCP 통합	서버 설정 추가, 통합 테스트
🎯 중간	워크플로우	명령어 패턴과 레시피 작성
🧪 중간	테스트	테스트 추가, 기능 검증
🌐 낮음	국제화	문서를 다른 언어로 번역

---

⚖️ 라이선스

이 프로젝트는 MIT 라이선스 하에 라이선스가 부여됩니다 - 자세한 내용은 LICENSE 파일을 참조하세요.

---

⭐ Star 히스토리

---

🚀 SuperClaude 커뮤니티가 열정으로 구축

_{한계를 뛰어넘는 개발자들을 위해 ❤️로 제작되었습니다}

맨 위로 ↑