🚀 SuperClaude 프레임워크

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

📊 프레임워크 통계

브레인스토밍부터 배포까지 완전한 개발 라이프사이클을 다루는 30개의 슬래시 명령어.

🎯 개요

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

면책 조항

이 프로젝트는 Anthropic과 관련이 없거나 승인받지 않았습니다. Claude Code는 Anthropic에 의해 구축 및 유지 관리되는 제품입니다.

📖 개발자 및 기여자를 위한 안내

SuperClaude 프레임워크 작업을 위한 필수 문서:

💡 전문가 팁: Claude Code는 세션 시작 시 이러한 파일을 읽어 프로젝트 표준에 부합하는 일관되고 고품질의 개발을 보장합니다.

⚡ 빠른 설치

중요: 이전 문서에서 설명한 TypeScript 플러그인 시스템은 아직 사용할 수 없습니다(v5.0에서 계획). v4.x의 현재 설치 지침은 아래 단계를 따르세요.

현재 안정 버전 (v4.3.0)

SuperClaude는 현재 슬래시 명령어를 사용합니다.

옵션 1: pipx (권장)

# PyPI에서 설치
pipx install superclaude

# 명령어 설치 (/research, /index-repo, /agent, /recommend 설치)
superclaude install

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

설치 후, 명령어를 사용하려면 Claude Code를 재시작하세요:

• /sc:research - 병렬 검색으로 심층 웹 연구
• /sc:index-repo - 컨텍스트 최적화를 위한 리포지토리 인덱싱
• /sc:agent - 전문 AI 에이전트
• /sc:recommend - 명령어 추천
• /sc - 사용 가능한 모든 SuperClaude 명령어 표시

옵션 2: Git에서 직접 설치

# 리포지토리 클론
git clone https://github.com/SuperClaude-Org/SuperClaude_Framework.git
cd SuperClaude_Framework

# 설치 스크립트 실행
./install.sh

v5.0에서 제공 예정 (개발 중)

새로운 TypeScript 플러그인 시스템을 적극적으로 개발 중입니다(자세한 내용은 #419 참조). 릴리스 후 설치는 다음과 같이 단순화됩니다:

# 이 기능은 아직 사용할 수 없습니다
/plugin marketplace add SuperClaude-Org/superclaude-plugin-marketplace
/plugin install superclaude

상태: 개발 중. ETA는 설정되지 않았습니다.

향상된 성능 (선택적 MCP)

2-3배 빠른 실행과 30-50% 적은 토큰을 위해 선택적으로 MCP 서버를 설치할 수 있습니다:

# 향상된 성능을 위한 선택적 MCP 서버 (airis-mcp-gateway 경유):
# - Serena: 코드 이해 (2-3배 빠름)
# - Sequential: 토큰 효율적 추론 (30-50% 적은 토큰)
# - Tavily: 심층 연구를 위한 웹 검색
# - Context7: 공식 문서 검색
# - Mindbase: 모든 대화에 걸친 의미론적 검색 (선택적 향상)

# 참고: 오류 학습은 내장 ReflexionMemory를 통해 사용 가능 (설치 불필요)
# Mindbase는 의미론적 검색 향상을 제공 ("recommended" 프로필 필요)
# MCP 서버 설치: https://github.com/agiletec-inc/airis-mcp-gateway
# 자세한 내용은 docs/mcp/mcp-integration-policy.md 참조

성능 비교:

• MCP 없음: 완전히 기능함, 표준 성능 ✅
• MCP 사용: 2-3배 빠름, 30-50% 적은 토큰 ⚡

💖 프로젝트 후원하기

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

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

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

☕ Ko-fi

일회성 기여

🎯 Patreon

월간 후원

💜 GitHub

유연한 티어

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

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

🎉 V4.1의 새로운 기능

버전 4.1은 슬래시 명령어 아키텍처 안정화, 에이전트 기능 강화 및 문서 개선에 중점을 둡니다.

🤖 더 스마트한 에이전트 시스템

도메인 전문성을 가진 16개의 전문 에이전트:

• PM Agent는 체계적인 문서화를 통해 지속적인 학습 보장
• 자율적인 웹 연구를 위한 심층 연구 에이전트
• 보안 엔지니어가 실제 취약점 포착
• 프론트엔드 아키텍트가 UI 패턴 이해
• 컨텍스트 기반 자동 조정
• 필요 시 도메인별 전문 지식 제공

⚡ 최적화된 성능

더 작은 프레임워크, 더 큰 프로젝트:

• 프레임워크 풋프린트 감소
• 코드를 위한 더 많은 컨텍스트
• 더 긴 대화 가능
• 복잡한 작업 활성화

🔧 MCP 서버 통합

8개의 강력한 서버 (airis-mcp-gateway 경유):

• Tavily → 주요 웹 검색(심층 연구)
• Serena → 세션 지속성 및 메모리
• Mindbase → 세션 간 학습(제로 풋프린트)
• Sequential → 토큰 효율적 추론
• Context7 → 공식 문서 검색
• Playwright → JavaScript 중심 콘텐츠 추출
• Magic → UI 컴포넌트 생성
• Chrome DevTools → 성능 분석

🎯 동작 모드

다양한 컨텍스트를 위한 7가지 적응형 모드:

• 브레인스토밍 → 적절한 질문하기
• 비즈니스 패널 → 다중 전문가 전략 분석
• 심층 연구 → 자율적인 웹 연구
• 오케스트레이션 → 효율적인 도구 조정
• 토큰 효율성 → 30-50% 컨텍스트 절약
• 작업 관리 → 체계적인 구성
• 성찰 → 메타인지 분석

📚 문서 전면 개편

개발자를 위한 완전한 재작성:

• 실제 예제와 사용 사례
• 일반적인 함정 문서화
• 실용적인 워크플로우 포함
• 개선된 탐색 구조

🧪 안정성 강화

신뢰성에 중점:

• 핵심 명령어 버그 수정
• 테스트 커버리지 개선
• 더 견고한 오류 처리
• CI/CD 파이프라인 개선

🔬 심층 연구 기능

DR 에이전트 아키텍처에 맞춘 자율적 웹 연구

SuperClaude v4.2는 자율적이고 적응적이며 지능적인 웹 연구를 가능하게 하는 포괄적인 심층 연구 기능을 도입합니다.

🎯 적응형 계획

세 가지 지능형 전략:

• 계획만: 명확한 쿼리에 대한 직접 실행
• 의도 계획: 모호한 요청에 대한 명확화
• 통합: 협업 계획 개선(기본값)

🔄 다중 홉 추론

최대 5회 반복 검색:

• 엔터티 확장(논문 → 저자 → 작품)
• 개념 심화(주제 → 세부사항 → 예제)
• 시간적 진행(현재 → 과거)
• 인과 체인(효과 → 원인 → 예방)

📊 품질 점수

신뢰도 기반 검증:

• 출처 신뢰성 평가(0.0-1.0)
• 커버리지 완전성 추적
• 종합 일관성 평가
• 최소 임계값: 0.6, 목표: 0.8

🧠 사례 기반 학습

세션 간 지능:

• 패턴 인식 및 재사용
• 시간 경과에 따른 전략 최적화
• 성공적인 쿼리 공식 저장
• 성능 개선 추적

연구 명령어 사용

# 자동 깊이로 기본 연구
/research "2024년 최신 AI 개발"

# 제어된 연구 깊이(TypeScript의 옵션 통해)
/research "양자 컴퓨팅 혁신"  # depth: exhaustive

# 특정 전략 선택
/research "시장 분석"  # strategy: planning-only

# 도메인 필터링 연구(Tavily MCP 통합)
/research "React 패턴"  # domains: reactjs.org,github.com

연구 깊이 수준

통합 도구 오케스트레이션

심층 연구 시스템은 여러 도구를 지능적으로 조정합니다:

• Tavily MCP: 주요 웹 검색 및 발견
• Playwright MCP: 복잡한 콘텐츠 추출
• Sequential MCP: 다단계 추론 및 종합
• Serena MCP: 메모리 및 학습 지속성
• Context7 MCP: 기술 문서 검색

📚 문서

🇰🇷 SuperClaude 완전 한국어 가이드

• 📝 빠른 시작 가이드
  즉시 시작하기

• 💾 설치 가이드
  상세한 설정 단계

• 🎯 슬래시 명령어 완전한 /sc 명령어 목록

• 🤖 에이전트 가이드 16개 전문 에이전트

• 🎨 동작 모드 7가지 적응형 모드

• 🚩 플래그 가이드 동작 제어 매개변수

• 🔧 MCP 서버 8개 서버 통합

• 💼 세션 관리 상태 저장 및 복원

• 🏗️ 기술 아키텍처
  시스템 설계 세부사항

• 💻 코드 기여
  개발 워크플로우

• 🧪 테스트 및 디버깅
  품질 보증

• 📓 예제 모음 실제 사용 예제

• 🔍 문제 해결 일반적인 문제와 수정

🤝 기여하기

SuperClaude 커뮤니티에 참여하세요

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

⚖️ 라이선스

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

⭐ Star 히스토리

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

📋 전체 30개 명령어

🧠 계획 및 설계 (4)

• /brainstorm - 구조화된 브레인스토밍
• /design - 시스템 아키텍처
• /estimate - 시간/노력 추정
• /spec-panel - 사양 분석

💻 개발 (5)

• /implement - 코드 구현
• /build - 빌드 워크플로우
• /improve - 코드 개선
• /cleanup - 리팩토링
• /explain - 코드 설명

🧪 테스트 및 품질 (4)

• /test - 테스트 생성
• /analyze - 코드 분석
• /troubleshoot - 디버깅
• /reflect - 회고

📚 문서화 (2)

• /document - 문서 생성
• /help - 명령어 도움말

🔧 버전 관리 (1)

• /git - Git 작업

📊 프로젝트 관리 (3)

• /pm - 프로젝트 관리
• /task - 작업 추적
• /workflow - 워크플로우 자동화

🔍 연구 및 분석 (2)

• /research - 심층 웹 연구
• /business-panel - 비즈니스 분석

🎯 유틸리티 (9)

• /agent - AI 에이전트
• /index-repo - 리포지토리 인덱싱
• /index - 인덱스 별칭
• /recommend - 명령어 추천
• /select-tool - 도구 선택
• /spawn - 병렬 작업
• /load - 세션 로드
• /save - 세션 저장
• /sc - 모든 명령어 표시

📖 상세 명령어 참조 보기 →