# 🚀 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를 유지하는 데는 시간과 리소스가 필요합니다. > > *테스트를 위한 Claude Max 구독료만 매월 100달러이고, 거기에 문서화, 버그 수정, 기능 개발에 쓰는 시간이 추가됩니다.* > *일상 업무에서 SuperClaude의 가치를 느끼신다면, 프로젝트 후원을 고려해주세요.* > *몇 달러라도 기본 비용을 충당하고 개발을 계속할 수 있게 해줍니다.* > > 코드, 피드백, 또는 후원을 통해, 모든 기여자가 중요합니다. 이 커뮤니티의 일원이 되어주셔서 감사합니다! 🙏

### ☕ **Ko-fi** [](https://ko-fi.com/superclaude) *일회성 기여*

### 🎯 **Patreon** [](https://patreon.com/superclaude) *월간 후원*

### 💜 **GitHub** [](https://github.com/sponsors/SuperClaude-Org) *유연한 티어*

### **여러분의 후원으로 가능한 것들:** | 항목 | 비용/영향 | |------|-------------| | 🔬 **Claude Max 테스트** | 검증과 테스트를 위해 월 100달러 | | ⚡ **기능 개발** | 새로운 기능과 개선 사항 | | 📚 **문서화** | 포괄적인 가이드와 예제 | | 🤝 **커뮤니티 지원** | 신속한 이슈 대응과 도움 | | 🔧 **MCP 통합** | 새로운 서버 연결 테스트 | | 🌐 **인프라** | 호스팅 및 배포 비용 | > **참고:** 하지만 부담은 없습니다. 프레임워크는 어쨌든 오픈소스로 유지됩니다. 사람들이 사용하고 가치를 느끼고 있다는 것만 알아도 동기부여가 됩니다. 코드, 문서, 또는 정보 확산을 통한 기여도 큰 도움이 됩니다! 🙏

## 🎉 **V4의 새로운 기능** > *버전 4는 커뮤니티 피드백과 실제 사용 패턴을 기반으로 중요한 개선 사항을 제공합니다.*

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

## 📚 **문서** ### **🇰🇷 SuperClaude 완전 한국어 가이드**

🚀 시작하기	📖 사용자 가이드	🛠️ 개발자 리소스	📋 레퍼런스
- 📝 [**빠른 시작 가이드**](docs/Getting-Started/quick-start.md) *즉시 시작하기* - 💾 [**설치 가이드**](docs/Getting-Started/installation.md) *상세한 설정 단계*	- 🎯 [**명령어 레퍼런스**](docs/User-Guide/commands.md) *전체 21개 슬래시 명령어* - 🤖 [**에이전트 가이드**](docs/User-Guide/agents.md) *14개 전문 에이전트* - 🎨 [**작동 모드**](docs/User-Guide/modes.md) *5가지 적응형 모드* - 🚩 [**플래그 가이드**](docs/User-Guide/flags.md) *동작 제어 매개변수* - 🔧 [**MCP 서버**](docs/User-Guide/mcp-servers.md) *6개 서버 통합* - 💼 [**세션 관리**](docs/User-Guide/session-management.md) *상태 저장 및 복원*	- 🏗️ [**기술 아키텍처**](docs/Developer-Guide/technical-architecture.md) *시스템 설계 세부사항* - 💻 [**코드 기여**](docs/Developer-Guide/contributing-code.md) *개발 워크플로우* - 🧪 [**테스트 및 디버깅**](docs/Developer-Guide/testing-debugging.md) *품질 보증*	- ✨ [**모범 사례**](docs/Reference/quick-start-practices.md) *전문가 팁과 패턴* - 📓 [**예제 모음**](docs/Reference/examples-cookbook.md) *실제 사용 예제* - 🔍 [**문제 해결**](docs/Reference/troubleshooting.md) *일반적인 문제와 수정*

## 🤝 **기여하기** ### **SuperClaude 커뮤니티에 참여하세요** 모든 종류의 기여를 환영합니다! 도움을 줄 수 있는 방법: | 우선순위 | 영역 | 설명 | |:--------:|------|-------------| | 📝 **높음** | 문서 | 가이드 개선, 예제 추가, 오타 수정 | | 🔧 **높음** | MCP 통합 | 서버 설정 추가, 통합 테스트 | | 🎯 **중간** | 워크플로우 | 명령어 패턴과 레시피 작성 | | 🧪 **중간** | 테스트 | 테스트 추가, 기능 검증 | | 🌐 **낮음** | 국제화 | 문서를 다른 언어로 번역 |

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

## ⭐ **Star 히스토리**

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

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

맨 위로 ↑