SuperClaude 플래그 사용자 가이드 🏁
🤖 대부분의 플래그는 자동으로 활성화됩니다 - 걱정하지 마세요!
솔직한 이야기: 이 플래그들을 외울 필요 없습니다. SuperClaude가 여러분이 하는 작업에 따라 유용한 플래그를 자동으로 추가하려고 노력합니다!
실제로 일어나는 일:
- /analyze auth.js 입력
- SuperClaude가 보안 관련 코드임을 감지
- 대체로 --persona-security, --focus security, --validate를 자동 추가
- 플래그를 신경 쓰지 않아도 전문가 수준의 보안 분석을 자주 받게 됨
직접 플래그를 써야 하는 경우는?
- SuperClaude가 선택한 값을 수동으로 바꾸고 싶을 때 (드물게)
- 특정 측면이 궁금할 때 (--focus performance 등)
- 다양한 방식을 실험하고 싶을 때
핵심 요약: 기본 명령어만 쓰고 자동 활성화에 맡기세요. 이 플래그들은 필요할 때만 참고하면 됩니다. 🎯
🚀 그냥 이거부터 써보세요 (플래그 몰라도 됨)
# 플래그를 몰라도 잘 동작합니다:
/sc:analyze src/ # 분석 플래그 자동 선택
/sc:build # 프로젝트에 맞게 자동 최적화
/sc:improve messy-code.js # 품질 및 안전 플래그 자동 활성화
/sc:troubleshoot "weird error" # 디버깅 및 분석 플래그 자동 활성화보셨죠? 플래그 몰라도 됩니다. 아래 내용은 내부 동작이 궁금할 때만 참고하세요.
SuperClaude의 플래그 시스템 실용 가이드. 플래그는 SuperClaude의 동작을 바꾸는 명령줄 옵션입니다. 명령어의 슈퍼파워라고 생각하세요.
플래그란? 🤔
플래그는 수정자로, SuperClaude가 요청을 처리하는 방식을 바꿉니다. 명령어 뒤에 --로 시작합니다.
기본 문법 (알 필요 거의 없음):
/sc:command --flag-name
/sc:command --flag-name 값
/sc:analyze src/ --focus security --depth deep실제로 플래그가 동작하는 방식:
- 자동 활성화 - SuperClaude가 맥락에 따라 플래그를 추가(주된 방식! 🎯)
- 수동 오버라이드 - 원하는 동작을 위해 직접 추가 가능
플래그의 존재 이유 (대부분 자동 혜택):
- 더 나은, 더 집중된 결과 제공
- 적정한 사고 깊이 자동 설정
- 필요시 특수 기능 활성화
- 작업에 따라 속도/상세 최적화
- 실제로 집중해야 할 부분에 주의 집중
핵심: SuperClaude가 플래그 선택을 똑똑하게 처리하므로 신경 쓸 필요 없습니다! 🧠
플래그 카테고리 📂
기획 & 분석 플래그 🧠
요청에 대해 SuperClaude가 얼마나 깊게 사고할지 제어합니다.
--plan
기능: 실행 계획을 먼저 보여줌
언제 사용: SuperClaude가 뭘 할지 미리 보고 싶을 때
예시: /build --plan - 빌드 단계를 실행 전 미리 보기
--think
기능: 다중 파일 분석(~4K 토큰)
언제 사용: 여러 파일이 얽힌 복잡한 문제
자동 활성화: 5개 이상 import 체인, 10회 이상 모듈 호출
예시: /analyze complex-system/ --think
--think-hard
기능: 심층 아키텍처 분석(~10K 토큰)
언제 사용: 시스템 전체 문제, 아키텍처 결정
자동 활성화: 시스템 리팩토링, 3개 이상 모듈 병목
예시: /improve legacy-system/ --think-hard
--ultrathink
기능: 최대 깊이 분석(~32K 토큰)
언제 사용: 핵심 시스템 재설계, 복잡한 디버깅
자동 활성화: 레거시 현대화, 치명적 취약점
예시: /troubleshoot "entire auth system broken" --ultrathink
💡 팁: --think부터 시작, 필요시만 더 깊게. 깊을수록 느리지만 더 철저함.
효율 & 제어 플래그 ⚡
출력 스타일, 안전성, 성능 제어.
--uc / --ultracompressed
기능: 기호를 이용해 60~80% 토큰 압축
언제 사용: 대규모 작업, 맥락이 꽉 찰 때
자동 활성화: 맥락 사용량 75% 이상, 대규모 작업
예시: /analyze huge-codebase/ --uc
--safe-mode
기능: 최대 검증, 보수적 실행
언제 사용: 운영 환경, 위험한 작업
자동 활성화: 리소스 사용 85% 이상, 운영 환경
예시: /improve production-code/ --safe-mode
--validate
기능: 작업 전 검증 및 위험 평가
언제 사용: 변경 전 점검 필요시
자동 활성화: 위험 점수 0.7 이상
예시: /cleanup legacy/ --validate
--verbose
기능: 최대 상세 설명
언제 사용: 학습, 디버깅, 전체 맥락 필요시
예시: /build --verbose - 빌드 단계 모두 보기
--answer-only
기능: 워크플로우 생성 없이 직접 답변
언제 사용: 빠른 질문, 자동화 원치 않을 때
예시: /explain React hooks --answer-only
💡 팁: --uc는 대규모 작업에, --safe-mode는 중요한 작업에, --verbose는 학습할 때 유용.
MCP 서버 플래그 🔧
MCP 서버를 통한 특수 기능 활성화.
--c7 / --context7
기능: 공식 라이브러리 문서화(Context7) 활성화
언제 사용: 프레임워크, 공식 문서 필요시
자동 활성화: 외부 라이브러리 import, 프레임워크 질문
예시: /build react-app/ --c7 - React 모범 사례 제공
--seq / --sequential
기능: 복잡한 다단계 분석(Sequential) 활성화
언제 사용: 복잡한 디버깅, 시스템 설계
자동 활성화: 복잡한 디버깅, --think 플래그
예시: /troubleshoot "auth flow broken" --seq
--magic
기능: UI 컴포넌트 생성(Magic) 활성화
언제 사용: UI 컴포넌트, 디자인 시스템 생성
자동 활성화: UI 요청, 프론트엔드 전문가
예시: /build dashboard --magic - 최신 UI 컴포넌트 생성
--play / --playwright
기능: 브라우저 자동화/테스트(Playwright) 활성화
언제 사용: E2E 테스트, 성능 모니터링
자동 활성화: 테스트 워크플로우, QA 전문가
예시: /test e2e --play
--all-mcp
기능: 모든 MCP 서버 동시 활성화
언제 사용: 복합 도메인 문제
자동 활성화: 문제 복잡도 0.8 이상, 다중 도메인
예시: /analyze entire-app/ --all-mcp
--no-mcp
기능: 모든 MCP 서버 비활성화, 네이티브 도구만 사용
언제 사용: 빠른 실행, 특수 기능 불필요
예시: /analyze simple-script.js --no-mcp
💡 팁: MCP 서버는 기능을 더하지만 토큰도 더 씀. --c7은 문서, --seq는 사고, --magic은 UI용.
고급 오케스트레이션 플래그 🎭
복잡한 작업 및 워크플로우용.
--delegate [files|folders|auto]
기능: 하위 에이전트 위임으로 병렬 처리
언제 사용: 대규모 코드베이스, 복잡 분석
자동 활성화: 7개 디렉터리 이상 또는 50개 파일 이상
옵션:
- files - 개별 파일 분석 위임
- folders - 디렉터리 단위 분석 위임
- auto - 스마트 위임 전략
예시: /analyze monorepo/ --delegate auto
--wave-mode [auto|force|off]
기능: 다단계 실행, 복합 지능
언제 사용: 복잡 개선, 체계적 분석
자동 활성화: 복잡도 0.8 이상, 파일 20개 이상, 작업 2종 이상
예시: /improve legacy-system/ --wave-mode force
--loop
기능: 반복 개선 모드
언제 사용: 품질 개선, 정제 작업
자동 활성화: Polish, refine, enhance 키워드
예시: /improve messy-code.js --loop
--concurrency [n]
기능: 최대 동시 하위 에이전트 수(1~15) 제어
언제 사용: 리소스 사용 조절
예시: /analyze --delegate auto --concurrency 3
💡 팁: 강력하지만 복잡. 대규모 프로젝트는 --delegate auto, 개선 작업은 --loop 추천.
초점 & 범위 플래그 🎯
SuperClaude의 주의를 특정 영역에 집중.
--scope [level]
옵션: file, module, project, system
기능: 분석 범위 설정
예시: /analyze --scope module auth/
--focus [domain]
옵션: performance, security, quality, architecture, accessibility, testing
기능: 특정 도메인에 분석 집중
예시: /analyze --focus security --scope project
Persona 플래그
사용 가능 전문가: architect, frontend, backend, analyzer, security, mentor, refactorer, performance, qa, devops, scribe
기능: 전문 분야 행동 패턴 활성화
예시: /analyze --persona-security - 보안 중심 분석
💡 팁: --focus는 타깃 분석에 유용. 페르소나는 자동 활성화되지만 수동 제어도 가능.
주요 플래그 패턴 🔄
빠른 분석
/sc:analyze src/ --focus quality # 빠른 품질 점검
/sc:analyze --uc --focus security # 빠른 보안 점검심층 조사
/sc:troubleshoot "bug" --think --seq # 체계적 디버깅
/sc:analyze --think-hard --focus architecture # 아키텍처 분석대규모 프로젝트 작업
/sc:analyze monorepo/ --delegate auto --uc # 효율적 대규모 분석
/sc:improve legacy/ --wave-mode auto --safe-mode # 안전한 체계적 개선학습 & 문서화
/sc:explain React hooks --c7 --verbose # 공식 문서와 함께 상세 설명
/sc:document api/ --persona-scribe # 전문가 수준 문서화성능 중심
/sc:analyze --focus performance --play # 테스트와 함께 성능 분석
/sc:build --uc --no-mcp # 추가 기능 없이 빠른 빌드보안 중심
/sc:analyze --focus security --think --validate # 철저한 보안 분석
/sc:scan --persona-security --safe-mode # 보수적 보안 검사실전 예시 💡
전/후: 기본 분석
전 (기본):
/sc:analyze auth.js
# → 단순 파일 분석후 (플래그 추가):
/sc:analyze auth.js --focus security --think --c7
# → 보안 중심 심층 분석 + 공식 문서 참고
# → 더 철저하게 보안 패턴, 모범 사례 점검전/후: 대규모 프로젝트
전 (느림):
/sc:analyze huge-monorepo/
# → 전체를 한 번에 분석, 토큰 초과/타임아웃 위험후 (효율적):
/sc:analyze huge-monorepo/ --delegate auto --uc --focus architecture
# → 하위 에이전트 위임, 출력 압축, 아키텍처 집중
# → 더 빠르고 집중된 결과전/후: 개선 작업
전 (위험):
/sc:improve legacy-system/
# → 변경이 너무 많아져서 문제 발생 가능후 (안전):
/sc:improve legacy-system/ --safe-mode --loop --validate --preview
# → 안전 변경, 반복적 접근, 사전 검증, 미리보기 제공
# → 점진적이고 안전한 개선자동 활성화 예시 🤖
SuperClaude는 맥락에 따라 플래그를 자동 추가합니다. 예시:
복잡도 기반
/sc:analyze huge-codebase/
# 자동 추가: --delegate auto --uc
# 이유: 50개 이상 파일, 맥락 관리 필요
/sc:troubleshoot "complex system issue"
# 자동 추가: --think --seq
# 이유: 다중 컴포넌트 문제 감지도메인 기반
/sc:build react-app/
# 자동 추가: --c7 --persona-frontend
# 이유: 프론트엔드 프레임워크 감지
/sc:analyze --focus security
# 자동 추가: --persona-security --validate
# 이유: 보안 중심 분석 요청성능 기반
# 맥락 사용량 75% 이상
/sc:analyze large-project/
# 자동 추가: --uc
# 이유: 토큰 최적화 필요
# 위험 점수 0.7 이상
/sc:improve production-code/
# 자동 추가: --safe-mode --validate
# 이유: 고위험 작업 감지고급 사용법 🚀
복합 플래그 조합
종합 코드 리뷰:
/sc:review codebase/ --persona-qa --think-hard --focus quality --validate --c7
# → QA 전문가 + 심층 분석 + 품질 집중 + 검증 + 공식 문서레거시 시스템 현대화:
/sc:improve legacy/ --wave-mode force --persona-architect --safe-mode --loop --c7
# → 웨이브 오케스트레이션 + 아키텍트 시각 + 안전 + 반복 + 문서보안 감사:
/sc:scan --persona-security --ultrathink --focus security --validate --seq
# → 보안 전문가 + 최대 사고 + 보안 집중 + 검증 + 체계적 분석성능 최적화
속도 중시:
/sc:analyze --no-mcp --uc --scope file
# → 부가 기능 비활성화, 출력 압축, 범위 제한철저함 중시:
/sc:analyze --all-mcp --think-hard --delegate auto
# → 모든 기능, 심층 사고, 병렬 처리커스텀 워크플로우
버그 조사 워크플로우:
/sc:troubleshoot "specific error" --seq --think --validate
/sc:analyze affected-files/ --focus quality --persona-analyzer
/sc:test --play --coverage기능 개발 워크플로우:
/sc:design new-feature --persona-architect --c7
/sc:build --magic --persona-frontend --validate
/sc:test --play --coverage
/sc:document --persona-scribe --c7빠른 참조 📋
가장 유용한 플래그
| 플래그 | 목적 | 사용 시점 |
|---|---|---|
| --think | 심층 분석 | 복잡 문제 |
| --uc | 출력 압축 | 대규모 작업 |
| --safe-mode | 보수 실행 | 중요한 코드 |
| --c7 | 공식 문서 | 프레임워크 작업 |
| --seq | 체계 분석 | 디버깅 |
| --focus security | 보안 집중 | 보안 관련 |
| --delegate auto | 병렬 처리 | 대규모 코드 |
| --validate | 변경 전 점검 | 위험 작업 |
잘 어울리는 플래그 조합
# 안전 개선
--safe-mode --validate --preview
# 심층 분석
--think --seq --c7
# 대규모 프로젝트
--delegate auto --uc --focus
# 학습
--verbose --c7 --persona-mentor
# 보안 작업
--persona-security --focus security --validate
# 성능 작업
--persona-performance --focus performance --play자동 활성화 트리거
- --think: 복잡 import, 모듈 간 호출
- --uc: 맥락 75% 이상, 대규모 작업
- --safe-mode: 리소스 85% 이상, 운영 환경
- --delegate: 7개 디렉터리 이상, 50개 파일 이상
- --c7: 프레임워크 import, 문서 요청
- --seq: 디버깅 키워드, --think 플래그
- 페르소나: 도메인별 키워드/패턴
플래그 문제 해결 🚨
흔한 문제
"플래그가 동작하지 않아요"
- 철자 확인(예: --ultracompresed, --persona-fronted 오타)
- 일부 플래그는 값 필요: --scope project, --focus security 등
- 플래그 충돌: --no-mcp는 --c7, --seq 등 MCP 플래그 무효화
"작업이 너무 느려요"
- --uc로 압축
- --no-mcp로 부가 기능 비활성화
- --scope file로 범위 제한
"출력이 너무 많아요"
- --uc로 압축
- --verbose 제거
- --answer-only로 간단 답변만
"분석이 충분히 철저하지 않아요"
- --think 또는 --think-hard 추가
- --seq, --c7 등 MCP 서버 활성화
- --persona-analyzer 등 전문가 지정
"변경이 너무 위험해요"
- 중요한 코드엔 항상 --safe-mode
- --validate로 사전 점검
- --preview로 미리보기
플래그 충돌
이 플래그는 다른 것보다 우선함:
- --no-mcp는 모든 MCP 플래그(--c7, --seq 등) 무효화
- --safe-mode는 최적화 플래그보다 우선
- 마지막 페르소나 플래그가 적용됨: --persona-frontend --persona-backend → backend
우선순위:
- 안전 플래그(--safe-mode)가 최적화보다 우선
- 명시적 플래그가 자동 활성화보다 우선
- 사고 깊이: --ultrathink > --think-hard > --think
- 범위: system > project > module > file
효과적인 플래그 사용 팁 💡
처음 시작할 때(진짜 현실)
- 처음엔 플래그 무시 - 자동 활성화가 거의 다 처리
- 자동 활성화된 플래그 관찰 - SuperClaude가 뭘 선택하는지 보며 익히세요
- 궁금하면 --help 사용 - 많은 명령어가 사용 가능한 플래그 안내
- 자동화 신뢰 - SuperClaude가 보통 합리적 기본값을 선택
고급 사용(원한다면)
- 오버라이드 실험 - 보안 코드가 아니어도 --persona-security 등으로 관점 변화
- 유용한 조합 익히기 - 중요한 작업엔 --safe-mode --validate
- 성능 트레이드오프 이해 - 빠름(--uc --no-mcp) vs 철저함(--think-hard --all-mcp)
- 학습용 플래그 활용 - --verbose로 내부 동작 이해
성능 팁(고급 사용자용)
- 속도: --uc --no-mcp --scope file
- 철저함: --think-hard --all-mcp --delegate auto
- 안전: --safe-mode --validate --preview
- 학습: --verbose --c7 --persona-mentor
마지막 참고사항 📝
플래그의 진짜 진실 💯:
- 자동 활성화가 수동 선택보다 대체로 잘 동작합니다
- 이 가이드 대부분을 무시하고 기본 명령어만 사용해도 됩니다
- 플래그는 필요할 때만 참고 - 반드시 알아야 하는 건 아님
- 학습은 가이드보다 실제 사용 중에 자연스럽게 됩니다 😊
압박감 느끼지 마세요 🧘♂️:
- SuperClaude는 플래그 몰라도 잘 동작하도록 설계됨
- 위의 상세 정보는 궁금할 때만 참고
- 자동 활성화가 사용 패턴에 따라 계속 똑똑해짐
- 플래그를 외우지 않아도 놓치는 것 없음
플래그가 실제로 필요한 경우:
- 자동 활성화 오버라이드(드물게)
- 다양한 방식 실험(재미)
- 특정 성능 최적화(고급)
- 동작 내역 학습(교육적)
간단하게 시작, 간단하게 유지 🎯:
- 기본 명령어: /analyze, /build, /improve 사용
- 복잡한 건 자동 활성화에 맡기기
- 직접 플래그 추가는 실험할 때만
- SuperClaude의 자동화 능력을 신뢰하세요
이 모든 복잡함 뒤에 SuperClaude는 사실 매우 쉽습니다. 그냥 명령어부터 입력해보세요! 🚀
