.claude/commands/ 디렉토리에 슬래시 명령을 만들어 반복 워크플로우를 한 줄로 실행하는 방법.
슬래시 명령 — 반복 작업을 한 줄로 압축하기
팀에서 매일 반복하는 작업이 있습니다. PR 전 코드 리뷰 준비, 스프린트 종료 시 변경 사항 요약, 새 기능 추가 시 테스트 생성 등. 이런 작업을 매번 긴 프롬프트로 입력하는 것은 비효율적이고, 팀원마다 요청 방식이 달라 결과도 일관되지 않습니다. 커스텀 슬래시 명령은 이 문제를 해결합니다 — 복잡한 워크플로우를 /명령어 한 줄로 압축합니다.
슬래시 명령 생성 방법
프로젝트 루트에 .claude/commands/ 디렉토리를 만들고, 각 명령을 .md 파일로 저장합니다.
프로젝트 루트/
├── .claude/
│ └── commands/
│ ├── review.md → /review
│ ├── test-gen.md → /test-gen
│ ├── changelog.md → /changelog
│ └── deploy-check.md → /deploy-check
└── CLAUDE.md파일 이름이 슬래시 명령의 이름이 됩니다. Claude Code 세션에서 /review를 입력하면 review.md의 내용이 프롬프트로 실행됩니다.
실전 슬래시 명령 예시
/review — PR 제출 전 코드 리뷰
# .claude/commands/review.md
현재 스테이징된 변경사항(git diff --staged)을 검토해줘.
다음 항목을 체크하고 문제가 있으면 수정해줘:
1. TypeScript 타입 오류 또는 any 남용
2. 에러 핸들링 누락 (try-catch, null 체크)
3. 하드코딩된 값 (URL, API key, 매직 넘버)
4. 테스트 커버리지 — 새 함수에 테스트 없으면 추가
5. CLAUDE.md의 코딩 규칙 위반
문제 없으면 "✅ 리뷰 완료" 출력./test-gen — 선택한 파일의 테스트 자동 생성
# .claude/commands/test-gen.md
$ARGUMENTS 파일을 분석해서 단위 테스트를 작성해줘.
규칙:
- Jest + Testing Library 사용
- 정상 케이스, 엣지 케이스, 에러 케이스 모두 포함
- 기존 테스트 파일이 있으면 추가, 없으면 __tests__/ 에 생성
- 테스트 실행 후 통과 확인까지$ARGUMENTS는 명령 실행 시 전달하는 인자를 받습니다. /test-gen src/utils/formatter.ts처럼 사용합니다.
/changelog — 이번 주 변경 이력 요약
# .claude/commands/changelog.md
git log --since="7 days ago" --oneline 을 분석해서
개발자가 아닌 사람도 이해할 수 있는 변경 이력 요약을 만들어줘.
형식:
## 이번 주 업데이트 (날짜)
### 새 기능
- ...
### 개선
- ...
### 버그 수정
- ...
CHANGELOG.md 파일에 기존 내용 위에 추가.인자($ARGUMENTS) 활용 패턴
# 명령 실행 예시
/test-gen src/utils/formatter.ts
/review --strict # 엄격 모드
/deploy-check staging # 환경 지정
# commands/deploy-check.md 내부
$ARGUMENTS 환경에 배포하기 전 체크리스트를 실행해줘:
1. npm run build 통과 확인
2. 환경변수 .env.example과 대조
3. DB 마이그레이션 파일 누락 확인
4. 빌드 결과 번들 크기 분석팀 공유 vs 개인 명령
- 팀 공유 (.claude/commands/): 프로젝트에 커밋. 모든 팀원이 동일한 워크플로우 사용. 코드 리뷰, 배포 체크, 릴리즈 노트 등 팀 표준 프로세스.
- 개인 (~/.claude/commands/): 홈 디렉토리에 저장. 모든 프로젝트에서 사용 가능. 개인 선호 스타일, 특정 언어 도구 등.
# 개인 글로벌 명령 위치
~/.claude/commands/
├── my-review.md → 모든 프로젝트에서 /my-review
└── korean.md → 한국어로 설명해주는 개인 명령슬래시 명령의 진정한 가치는 "팀의 집단 지식을 코드화"하는 것입니다. 시니어 개발자가 PR 리뷰에서 항상 체크하는 항목들, 온보딩 시 신입에게 설명하는 코딩 규칙들 — 이것들을 슬래시 명령으로 만들면 팀 전체가 같은 기준으로 일관되게 작업합니다.
핵심 정리
- .claude/commands/*.md 파일이 /명령어로 사용됨 — 반복 프롬프트를 한 줄로 압축, 팀 표준 워크플로우로 코드화
- $ARGUMENTS로 파일·환경·옵션을 동적으로 전달 — /test-gen src/utils/parser.ts처럼 재사용 가능한 범용 명령 구성
- .claude/commands/ 커밋으로 팀 공유, ~/.claude/commands/로 개인 글로벌 명령 분리 관리
관련 검색어 · 클로드 코드 · Claude Code · 슬래시 명령 만들기 · .claude/commands · 커스텀 워크플로우 · 반복 작업 자동화 · 클로드 코드 명령어