SuperClaude/docs/User-Guide-kr/commands.md

SuperClaude 명령어 가이드

SuperClaude는 Claude Code를 위한 25개의 명령어를 제공합니다: 워크플로우를 위한 /sc:* 명령어와 전문가를 위한 @agent-*.

명령어 유형

유형	사용 위치	형식	예제
슬래시 명령어	Claude Code	/sc:[명령어]	/sc:implement "기능"
에이전트	Claude Code	@agent-[이름]	@agent-security "검토"
설치	터미널	SuperClaude [명령어]	SuperClaude install

빠른 테스트

# 터미널: 설치 확인
python3 -m SuperClaude --version
# Claude Code CLI 확인: claude --version

# Claude Code: 명령어 테스트
/sc:brainstorm "테스트 프로젝트"    # 발견 질문을 해야 함
/sc:analyze README.md              # 분석을 제공해야 함

워크플로우: /sc:brainstorm "아이디어" → /sc:implement "기능" → /sc:test

🎯 SuperClaude 명령어 이해하기

SuperClaude 작동 방식

SuperClaude는 Claude Code가 읽어 전문화된 동작을 채택하는 행동 컨텍스트 파일을 제공합니다. /sc:implement를 입력하면 Claude Code는 implement.md 컨텍스트 파일을 읽고 행동 지침을 따릅니다.

SuperClaude 명령어는 소프트웨어로 실행되지 않습니다 - 프레임워크의 전문 지침 파일을 읽어 Claude Code의 동작을 수정하는 컨텍스트 트리거입니다.

명령어 유형:

• 슬래시 명령어 (/sc:*): 워크플로우 패턴 및 행동 모드 트리거
• 에이전트 호출 (@agent-*): 특정 도메인 전문가를 수동으로 활성화
• 플래그 (--think, --safe-mode): 명령어 동작 및 깊이 수정

컨텍스트 메커니즘:

1. 사용자 입력: /sc:implement "인증 시스템" 입력
2. 컨텍스트 로딩: Claude Code가 ~/.claude/superclaude/Commands/implement.md 읽음
3. 동작 채택: Claude가 도메인 전문 지식, 도구 선택, 검증 패턴 적용
4. 향상된 출력: 보안 고려사항 및 모범 사례를 갖춘 구조화된 구현

핵심 포인트: 이는 전통적인 소프트웨어 실행이 아닌 컨텍스트 관리를 통해 정교한 개발 워크플로우를 만듭니다.

설치 vs 사용 명령어

🖥️ 터미널 명령어 (실제 CLI 소프트웨어):

• SuperClaude install - 프레임워크 컴포넌트 설치
• SuperClaude update - 기존 설치 업데이트
• SuperClaude uninstall - 프레임워크 설치 제거
• python3 -m SuperClaude --version - 설치 상태 확인

💬 Claude Code 명령어 (컨텍스트 트리거):

• /sc:brainstorm - 요구사항 발견 컨텍스트 활성화
• /sc:implement - 기능 개발 컨텍스트 활성화
• @agent-security - 보안 전문가 컨텍스트 활성화
• 모든 명령어는 Claude Code 채팅 인터페이스 내에서만 작동

빠른 시작: 핵심 워크플로우를 경험하려면 /sc:brainstorm "프로젝트 아이디어" → /sc:implement "기능 이름" → /sc:test를 시도해보세요.

🧪 설정 테스트

🖥️ 터미널 확인 (터미널/CMD에서 실행)

# SuperClaude 작동 확인 (주요 방법)
python3 -m SuperClaude --version
# 예상 출력: SuperClaude 4.1.5

# Claude Code CLI 버전 확인
claude --version

# 설치된 컴포넌트 확인
python3 -m SuperClaude install --list-components | grep mcp
# 예상 출력: 설치된 MCP 컴포넌트 표시

💬 Claude Code 테스트 (Claude Code 채팅에 입력)

# 기본 /sc: 명령어 테스트
/sc:brainstorm "테스트 프로젝트"
# 예상 동작: 대화형 요구사항 발견 시작

# 명령어 도움말 테스트
/sc:help
# 예상 동작: 사용 가능한 명령어 목록

테스트가 실패하면: 설치 가이드 또는 문제 해결 확인

📝 명령어 빠른 참조

명령어 유형	실행 위치	형식	목적	예제
🖥️ 설치	터미널/CMD	SuperClaude [명령어]	설정 및 유지보수	SuperClaude install
🔧 구성	터미널/CMD	python3 -m SuperClaude [명령어]	고급 구성	python3 -m SuperClaude --version
💬 슬래시 명령어	Claude Code	/sc:[명령어]	워크플로우 자동화	/sc:implement "기능"
🤖 에이전트 호출	Claude Code	@agent-[이름]	수동 전문가 활성화	@agent-security "검토"
⚡ 향상된 플래그	Claude Code	/sc:[명령어] --플래그	동작 수정	/sc:analyze --think-hard

기억하세요: 모든 /sc: 명령어와 @agent- 호출은 터미널이 아닌 Claude Code 채팅 내에서 작동합니다. 이들은 Claude Code가 SuperClaude 프레임워크에서 특정 컨텍스트 파일을 읽도록 트리거합니다.

목차

• 필수 명령어 - 여기서 시작하세요 (8개 핵심 명령어)
• 일반적인 워크플로우 - 작동하는 명령어 조합
• 전체 명령어 참조 - 카테고리별로 정리된 25개 명령어
• 문제 해결 - 일반적인 문제 및 해결책
• 명령어 인덱스 - 카테고리별로 명령어 찾기

---

필수 명령어

즉각적인 생산성을 위한 핵심 워크플로우 명령어:

/sc:brainstorm - 프로젝트 발견

목적: 대화형 요구사항 발견 및 프로젝트 계획 구문: /sc:brainstorm "아이디어" [--strategy systematic|creative]

사용 사례:

• 새 프로젝트 계획: /sc:brainstorm "전자상거래 플랫폼"
• 기능 탐색: /sc:brainstorm "사용자 인증 시스템"
• 문제 해결: /sc:brainstorm "느린 데이터베이스 쿼리"

/sc:help - 명령어 참조

목적: 사용 가능한 모든 /sc 명령어와 설명 목록 표시 구문: /sc:help

사용 사례:

• 사용 가능한 명령어 발견: /sc:help
• 명령어 이름 빠른 확인: /sc:help

/sc:research - 심층 연구 명령어

목적: 적응형 계획 및 지능형 검색을 통한 포괄적인 웹 연구 구문: /sc:research "[쿼리]" [--depth quick|standard|deep|exhaustive] [--strategy planning|intent|unified]

사용 사례:

• 기술 연구: /sc:research "최신 React 19 기능" --depth deep
• 시장 분석: /sc:research "2024년 AI 코딩 어시스턴트 현황" --strategy unified
• 학술 조사: /sc:research "양자 컴퓨팅 돌파구" --depth exhaustive
• 최신 정보: /sc:research "2024년 최신 AI 개발"

핵심 기능:

• 6단계 워크플로우: 이해 → 계획 → TodoWrite → 실행 → 추적 → 검증
• 적응형 깊이: Quick(기본 검색), Standard(확장), Deep(포괄적), Exhaustive(최대 깊이)
• 계획 전략: Planning(직접), Intent(먼저 명확화), Unified(협업)
• 병렬 실행: 기본 병렬 검색 및 추출
• 증거 관리: 관련성 점수가 있는 명확한 인용
• 출력 표준: 보고서가 claudedocs/research_[주제]_[타임스탬프].md에 저장됨

/sc:implement - 기능 개발

목적: 지능형 전문가 라우팅을 통한 풀스택 기능 구현 구문: /sc:implement "기능 설명" [--type frontend|backend|fullstack] [--focus security|performance]

사용 사례:

• 인증: /sc:implement "JWT 로그인 시스템"
• UI 컴포넌트: /sc:implement "반응형 대시보드"
• API: /sc:implement "REST 사용자 엔드포인트"
• 데이터베이스: /sc:implement "관계를 가진 사용자 스키마"

/sc:analyze - 코드 평가

목적: 품질, 보안, 성능에 걸친 포괄적인 코드 분석 구문: /sc:analyze [경로] [--focus quality|security|performance|architecture]

사용 사례:

• 프로젝트 상태: /sc:analyze .
• 보안 감사: /sc:analyze --focus security
• 성능 검토: /sc:analyze --focus performance

/sc:business-panel - 전략적 비즈니스 분석

목적: 9명의 저명한 사상가와 함께하는 다중 전문가 비즈니스 전략 분석 구문: /sc:business-panel "내용" [--mode discussion|debate|socratic] [--experts "name1,name2"]

사용 사례:

• 전략 평가: /sc:business-panel "우리의 시장 진출 전략"
• 경쟁 분석: /sc:business-panel @competitor_analysis.pdf --mode debate
• 혁신 평가: /sc:business-panel "AI 제품 아이디어" --experts "christensen,drucker"
• 전략적 학습: /sc:business-panel "경쟁 전략" --mode socratic

전문가 패널: Christensen, Porter, Drucker, Godin, Kim/Mauborgne, Collins, Taleb, Meadows, Doumont

/sc:spec-panel - 전문가 사양 검토

목적: 저명한 사양 및 소프트웨어 엔지니어링 전문가를 사용한 다중 전문가 사양 검토 및 개선 구문: /sc:spec-panel [내용|@파일] [--mode discussion|critique|socratic] [--focus requirements|architecture|testing|compliance]

사용 사례:

• 사양 검토: /sc:spec-panel @api_spec.yml --mode critique --focus requirements,architecture
• 요구사항 워크숍: /sc:spec-panel "사용자 스토리 내용" --mode discussion
• 아키텍처 검증: /sc:spec-panel @microservice.spec.yml --mode socratic --focus architecture
• 규정 준수 검토: /sc:spec-panel @security_requirements.yml --focus compliance
• 반복적 개선: /sc:spec-panel @complex_system.spec.yml --iterations 3

전문가 패널: Wiegers, Adzic, Cockburn, Fowler, Nygard, Newman, Hohpe, Crispin, Gregory, Hightower

/sc:troubleshoot - 문제 진단

목적: 근본 원인 분석을 통한 체계적인 문제 진단 구문: /sc:troubleshoot "문제 설명" [--type build|runtime|performance]

사용 사례:

• 런타임 오류: /sc:troubleshoot "로그인 시 500 오류"
• 빌드 실패: /sc:troubleshoot --type build
• 성능 문제: /sc:troubleshoot "느린 페이지 로드"

/sc:test - 품질 보증

목적: 커버리지 분석을 통한 포괄적인 테스팅 구문: /sc:test [--type unit|integration|e2e] [--coverage] [--fix]

사용 사례:

• 전체 테스트 스위트: /sc:test --coverage
• 단위 테스팅: /sc:test --type unit --watch
• E2E 검증: /sc:test --type e2e

/sc:improve - 코드 향상

목적: 체계적인 코드 개선 및 최적화 적용 구문: /sc:improve [경로] [--type performance|quality|security] [--preview]

사용 사례:

• 일반적인 개선: /sc:improve src/
• 성능 최적화: /sc:improve --type performance
• 보안 강화: /sc:improve --type security

/sc:document - 문서 생성

목적: 코드 및 API에 대한 포괄적인 문서 생성 구문: /sc:document [경로] [--type api|user-guide|technical] [--format markdown|html]

사용 사례:

• API 문서: /sc:document --type api
• 사용자 가이드: /sc:document --type user-guide
• 기술 문서: /sc:document --type technical

/sc:workflow - 구현 계획

목적: 요구사항에서 구조화된 구현 계획 생성 구문: /sc:workflow "기능 설명" [--strategy agile|waterfall] [--format markdown]

사용 사례:

• 기능 계획: /sc:workflow "사용자 인증"
• 스프린트 계획: /sc:workflow --strategy agile
• 아키텍처 계획: /sc:workflow "마이크로서비스 마이그레이션"

---

일반적인 워크플로우

검증된 명령어 조합:

새 프로젝트 설정

/sc:brainstorm "프로젝트 개념"      # 요구사항 정의
/sc:design "시스템 아키텍처"        # 기술 설계 생성
/sc:workflow "구현 계획"            # 개발 로드맵 생성

기능 개발

/sc:implement "기능 이름"           # 기능 구축
/sc:test --coverage                 # 테스트로 검증
/sc:document --type api             # 문서 생성

코드 품질 개선

/sc:analyze --focus quality         # 현재 상태 평가
/sc:improve --preview               # 개선 사항 미리보기
/sc:test --coverage                 # 변경 사항 검증

버그 조사

/sc:troubleshoot "문제 설명"       # 문제 진단
/sc:analyze --focus problem-area    # 심층 분석
/sc:improve --fix --safe-mode       # 대상 수정 적용

사양 개발

/sc:spec-panel @existing_spec.yml --mode critique  # 전문가 검토
/sc:spec-panel @improved_spec.yml --iterations 2    # 반복적 개선
/sc:document --type technical                        # 문서 생성

전체 명령어 참조

개발 명령어

명령어	목적	최적 사용처
workflow	구현 계획	프로젝트 로드맵, 스프린트 계획
implement	기능 개발	풀스택 기능, API 개발
build	프로젝트 컴파일	CI/CD, 프로덕션 빌드
design	시스템 아키텍처	API 스펙, 데이터베이스 스키마

분석 명령어

명령어	목적	최적 사용처
analyze	코드 평가	품질 감사, 보안 검토
research	지능형 검색을 통한 웹 연구	기술 연구, 최신 정보, 시장 분석
business-panel	전략적 분석	비즈니스 결정, 경쟁 평가
spec-panel	사양 검토	요구사항 검증, 아키텍처 분석
troubleshoot	문제 진단	버그 조사, 성능 문제
explain	코드 설명	학습, 코드 검토

품질 명령어

명령어	목적	최적 사용처
improve	코드 향상	성능 최적화, 리팩토링
cleanup	기술 부채	데드 코드 제거, 정리
test	품질 보증	테스트 자동화, 커버리지 분석
document	문서화	API 문서, 사용자 가이드

프로젝트 관리

명령어	목적	최적 사용처
estimate	프로젝트 추정	타임라인 계획, 리소스 할당
task	작업 관리	복잡한 워크플로우, 작업 추적
spawn	메타 오케스트레이션	대규모 프로젝트, 병렬 실행

유틸리티 명령어

명령어	목적	최적 사용처
help	모든 명령어 나열	사용 가능한 명령어 발견
git	버전 제어	커밋 관리, 브랜치 전략
index	명령어 발견	기능 탐색, 명령어 찾기

세션 명령어

명령어	목적	최적 사용처
load	컨텍스트 로딩	세션 초기화, 프로젝트 온보딩
save	세션 지속성	체크포인팅, 컨텍스트 보존
reflect	작업 검증	진행 상황 평가, 완료 검증
select-tool	도구 최적화	성능 최적화, 도구 선택

---

명령어 인덱스

기능별:

• 계획: brainstorm, design, workflow, estimate
• 개발: implement, build, git
• 분석: analyze, business-panel, spec-panel, troubleshoot, explain
• 품질: improve, cleanup, test, document
• 관리: task, spawn, load, save, reflect
• 유틸리티: help, index, select-tool

복잡성별:

• 초급: brainstorm, implement, analyze, test, help
• 중급: workflow, design, business-panel, spec-panel, improve, document
• 고급: spawn, task, select-tool, reflect

문제 해결

명령어 문제:

• 명령어를 찾을 수 없음: 설치 확인: python3 -m SuperClaude --version
• 응답 없음: Claude Code 세션 재시작
• 처리 지연: MCP 서버 없이 테스트하려면 --no-mcp 사용

빠른 수정:

• 세션 재설정: /sc:load로 다시 초기화
• 상태 확인: SuperClaude install --list-components
• 도움말 받기: 문제 해결 가이드

다음 단계

• 플래그 가이드 - 명령어 동작 제어
• 에이전트 가이드 - 전문가 활성화
• 예제 모음 - 실제 사용 패턴