커맨드 개요
커맨드는 슬래시(/)로 시작하는 빠른 실행 명령어입니다.
⚡
/plan, /tdd, /code-review 등으로 빠르게 작업을 시작할 수 있습니다.
커맨드란?
커맨드는 Claude Code에서 자주 사용하는 워크플로우를 빠르게 실행할 수 있는 단축키입니다.
커맨드의 구조
---
description: 커맨드 설명
---
# 커맨드 이름
커맨드가 수행하는 작업 설명...
## 이 커맨드가 하는 일
...
## 사용 시점
...커맨드 목록
📋 /plan🧪 /tdd👀 /code-review🔧 /build-fix🎭 /e2e🧹 /refactor-clean📊 /test-coverage📝 /update-docs🗺️ /update-codemaps
커맨드 사용 가이드
1. 언제 어떤 커맨드를 사용할까?
| 상황 | 추천 커맨드 | 다운로드 |
|---|---|---|
| 새 기능 시작 | /plan | |
| 테스트와 함께 개발 | /tdd | |
| 코드 변경 후 | /code-review | |
| 빌드 오류 발생 | /build-fix | |
| E2E 테스트 필요 | /e2e | |
| 코드 정리 필요 | /refactor-clean | |
| 커버리지 확인 | /test-coverage | |
| 문서 업데이트 | /update-docs | |
| 아키텍처 문서화 | /update-codemaps |
2. 커맨드 설치
# 모든 커맨드 복사
cp commands/*.md ~/.claude/commands/
# 또는 필요한 커맨드만
cp commands/tdd.md ~/.claude/commands/
cp commands/code-review.md ~/.claude/commands/3. 커맨드 실행
Claude Code 내에서 슬래시로 시작하는 커맨드를 입력:
/plan 사용자 인증 기능을 추가해야 합니다/tdd 새로운 API 엔드포인트를 만들어주세요/code-review워크플로우 예시
새 기능 개발 워크플로우
1. /plan - 구현 계획 수립
2. /tdd - 테스트 주도 개발로 구현
3. /code-review - 코드 품질 검토
4. /test-coverage - 커버리지 확인
5. /update-docs - 문서 업데이트버그 수정 워크플로우
1. /tdd - 버그를 재현하는 테스트 작성
2. 버그 수정
3. /build-fix - 빌드 오류 해결 (필요시)
4. /code-review - 수정 사항 검토리팩토링 워크플로우
1. /plan - 리팩토링 계획 수립
2. /refactor-clean - 불필요한 코드 정리
3. /code-review - 변경 사항 검토
4. /test-coverage - 테스트 커버리지 확인
5. /update-codemaps - 아키텍처 문서 업데이트커맨드 vs 에이전트
| 구분 | 커맨드 | 에이전트 |
|---|---|---|
| 호출 방식 | /command | 자동 또는 수동 |
| 목적 | 빠른 워크플로우 실행 | 복잡한 작업 위임 |
| 범위 | 단일 작업 | 여러 작업 |
| 상호작용 | 즉시 실행 | 대화형 |
⚠️
팁: 커맨드는 내부적으로 에이전트를 호출할 수 있습니다. 예를 들어 /plan 커맨드는 planner 에이전트를 호출합니다.
커맨드 커스터마이징
커맨드 파일을 수정하여 본인의 워크플로우에 맞게 조정할 수 있습니다:
---
description: 우리 팀 코드 리뷰 워크플로우
---
# 코드 리뷰
우리 팀의 코드 리뷰 체크리스트:
1. ESLint 규칙 확인
2. TypeScript 타입 검사
3. 우리 팀 컨벤션 확인
...모범 사례
- 순서대로 사용 -
/plan→/tdd→/code-review순서 권장 - 필요한 것만 - 모든 커맨드를 항상 사용할 필요 없음
- 피드백 반영 - 커맨드 결과를 검토하고 필요시 수정
- 자동화 - 자주 사용하는 커맨드 조합은 훅으로 자동화 고려