ContextQMD
Back to Superclaude Framework

SuperClaude 플래그 가이드 🏁

docs/user-guide-kr/flags.md

4.3.011.2 KB
Original Source

SuperClaude 플래그 가이드 🏁

대부분의 플래그는 자동으로 활성화됩니다 - Claude Code가 요청의 키워드와 패턴을 기반으로 적절한 컨텍스트를 참여시키는 행동 지침을 읽습니다.

필수 자동 활성화 플래그 (사용 사례의 90%)

핵심 분석 플래그

플래그활성화 시점수행 작업
--think5개 이상 파일 또는 복잡한 분석표준 구조화된 분석 (~4K 토큰)
--think-hard아키텍처 분석, 시스템 종속성향상된 도구를 사용한 심층 분석 (~10K 토큰)
--ultrathink중요한 시스템 재설계, 레거시 현대화모든 도구를 사용한 최대 깊이 분석 (~32K 토큰)

MCP 서버 플래그

플래그서버목적자동 트리거
--c7 / --context7Context7공식 문서, 프레임워크 패턴라이브러리 임포트, 프레임워크 질문
--seq / --sequentialSequential다단계 추론, 디버깅복잡한 디버깅, 시스템 설계
--magicMagicUI 컴포넌트 생성/ui 명령어, 프론트엔드 키워드
--play / --playwrightPlaywright브라우저 테스팅, E2E 검증테스팅 요청, 시각적 검증
--morph / --morphllmMorphllm대량 변환, 패턴 편집대량 작업, 스타일 강제
--serenaSerena프로젝트 메모리, 심볼 작업심볼 작업, 대규모 코드베이스

행동 모드 플래그

플래그활성화 시점수행 작업
--brainstorm모호한 요청, 탐색 키워드협업 발견 마인드셋
--introspect자기 분석, 오류 복구투명성을 갖춘 추론 과정 노출
--task-manage>3단계, 복잡한 범위위임을 통한 오케스트레이션
--orchestrate다중 도구 작업, 성능 필요도구 선택 및 병렬 실행 최적화
--token-efficient / --uc컨텍스트 >75%, 효율성 필요심볼 강화 커뮤니케이션, 30-50% 감소

실행 제어 플래그

플래그활성화 시점수행 작업
--loop"개선", "다듬기", "정제" 키워드반복적 향상 사이클
--safe-mode프로덕션, >85% 리소스 사용최대 검증, 보수적 실행
--validate위험 >0.7, 프로덕션 환경실행 전 위험 평가
--delegate>7개 디렉토리 또는 >50개 파일하위 에이전트 병렬 처리

명령어별 플래그

분석 명령어 플래그 (/sc:analyze)

플래그목적값
--focus특정 도메인 대상security, performance, quality, architecture
--depth분석 철저함quick, deep
--format출력 형식text, json, report

빌드 명령어 플래그 (/sc:build)

플래그목적값
--type빌드 구성dev, prod, test
--clean빌드 전 정리불린
--optimize최적화 활성화불린
--verbose상세 출력불린

디자인 명령어 플래그 (/sc:design)

플래그목적값
--type디자인 대상architecture, api, component, database
--format출력 형식diagram, spec, code

설명 명령어 플래그 (/sc:explain)

플래그목적값
--level복잡성 수준basic, intermediate, advanced
--format설명 스타일text, examples, interactive
--context도메인 컨텍스트모든 도메인 (예: react, security)

개선 명령어 플래그 (/sc:improve)

플래그목적값
--type개선 초점quality, performance, maintainability, style, security
--safe보수적 접근불린
--interactive사용자 안내불린
--preview실행 없이 표시불린

작업 명령어 플래그 (/sc:task)

플래그목적값
--strategy작업 접근법systematic, agile, enterprise
--parallel병렬 실행불린
--delegate하위 에이전트 조정불린

워크플로우 명령어 플래그 (/sc:workflow)

플래그목적값
--strategy워크플로우 접근법systematic, agile, enterprise
--depth분석 깊이shallow, normal, deep
--parallel병렬 조정불린

문제 해결 명령어 플래그 (/sc:troubleshoot)

플래그목적값
--type문제 카테고리bug, build, performance, deployment
--trace추적 분석 포함불린
--fix수정 적용불린

정리 명령어 플래그 (/sc:cleanup)

플래그목적값
--type정리 대상code, imports, files, all
--safe / --aggressive정리 강도불린
--interactive사용자 안내불린
--preview실행 없이 표시불린

추정 명령어 플래그 (/sc:estimate)

플래그목적값
--type추정 초점time, effort, complexity
--unit시간 단위hours, days, weeks
--breakdown상세 분해불린

인덱스 명령어 플래그 (/sc:index)

플래그목적값
--type인덱스 대상docs, api, structure, readme
--format출력 형식md, json, yaml

성찰 명령어 플래그 (/sc:reflect)

플래그목적값
--type성찰 범위task, session, completion
--analyze분석 포함불린
--validate완전성 검증불린

스폰 명령어 플래그 (/sc:spawn)

플래그목적값
--strategy조정 접근법sequential, parallel, adaptive
--depth분석 깊이normal, deep

Git 명령어 플래그 (/sc:git)

플래그목적값
--smart-commit커밋 메시지 생성불린
--interactive안내 작업불린

도구 선택 명령어 플래그 (/sc:select-tool)

플래그목적값
--analyze도구 분석불린
--explain선택 설명불린

테스트 명령어 플래그 (/sc:test)

플래그목적값
--coverage커버리지 포함불린
--type테스트 유형unit, integration, e2e
--watch감시 모드불린

고급 제어 플래그

범위 및 초점

플래그목적값
--scope분석 경계file, module, project, system
--focus도메인 타겟팅performance, security, quality, architecture, accessibility, testing

실행 제어

플래그목적값
--concurrency [n]병렬 작업 제어1-15
--iterations [n]개선 사이클1-10
--all-mcp모든 MCP 서버 활성화불린
--no-mcp네이티브 도구만불린

시스템 플래그 (SuperClaude 설치)

플래그목적값
--verbose / -v상세 로깅불린
--quiet / -q출력 억제불린
--dry-run작업 시뮬레이션불린
--force검사 건너뛰기불린
--yes / -y자동 확인불린
--install-dir대상 디렉토리경로
--legacy레거시 스크립트 사용불린
--version버전 표시불린
--help도움말 표시불린

일반적인 사용 패턴

프론트엔드 개발

bash
/sc:implement "반응형 대시보드" --magic --c7
/sc:design component-library --type component --format code
/sc:test ui-components/ --magic --play
/sc:improve legacy-ui/ --magic --morph --validate

백엔드 개발

bash
/sc:analyze api/ --focus performance --seq --think
/sc:design payment-api --type api --format spec
/sc:troubleshoot "API 타임아웃" --type performance --trace
/sc:improve auth-service --type security --validate

대규모 프로젝트

bash
/sc:analyze . --ultrathink --all-mcp --safe-mode
/sc:workflow enterprise-system --strategy enterprise --depth deep
/sc:cleanup . --type all --safe --interactive
/sc:estimate "마이크로서비스로 마이그레이션" --type complexity --breakdown

품질 및 유지보수

bash
/sc:improve src/ --type quality --safe --interactive
/sc:cleanup imports --type imports --preview
/sc:reflect --type completion --validate
/sc:git commit --smart-commit

플래그 상호작용

호환 가능한 조합

  • --think + --c7: 문서를 사용한 분석
  • --magic + --play: 테스팅을 사용한 UI 생성
  • --serena + --morph: 변환을 사용한 프로젝트 메모리
  • --safe-mode + --validate: 최대 안전성
  • --loop + --validate: 검증을 통한 반복적 개선

충돌하는 플래그

  • --all-mcp vs 개별 MCP 플래그 (하나만 사용)
  • --no-mcp vs 모든 MCP 플래그 (--no-mcp 우선)
  • --safe vs --aggressive (정리 강도)
  • --quiet vs --verbose (출력 수준)

자동 활성화 관계

  • --safe-mode는 --uc 및 --validate 자동 활성화
  • --ultrathink는 모든 MCP 서버 자동 활성화
  • --think-hard는 --seq + --c7 자동 활성화
  • --magic는 UI 중심 에이전트 트리거

플래그 문제 해결

일반적인 문제

  • 너무 많은 도구: 네이티브 도구만 테스트하려면 --no-mcp 사용
  • 작업이 너무 느림: 출력 압축을 위해 --uc 추가
  • 검증 차단: 개발 중에는 --safe-mode 대신 --validate 사용
  • 컨텍스트 압박: >75% 사용 시 --token-efficient 자동 활성화

디버그 플래그

bash
/sc:analyze . --verbose                      # 결정 로직 및 플래그 활성화 표시
/sc:select-tool "작업" --explain              # 도구 선택 과정 설명
/sc:reflect --type session --analyze         # 현재 세션 결정 검토

빠른 수정

bash
/sc:analyze . --help                         # 명령어에 사용 가능한 플래그 표시
/sc:analyze . --no-mcp                       # 네이티브 실행만
/sc:cleanup . --preview                      # 정리될 내용 표시

플래그 우선순위 규칙

  1. 안전 우선: --safe-mode > --validate > 최적화 플래그
  2. 명시적 재정의: 사용자 플래그 > 자동 감지
  3. 깊이 계층: --ultrathink > --think-hard > --think
  4. MCP 제어: --no-mcp가 모든 개별 MCP 플래그 재정의
  5. 범위 우선순위: system > project > module > file

관련 리소스